Phyll // Commands

Commands

Everything you can run with Phyll, from installing it to fixing your app. The npx commands run in any terminal; the lines with > are what you type in your agent.

Install and connect

Once per computer. Setup connects Phyll to your agent and installs the browser it uses.

$ npx phyll setup codex     # connect Phyll to Codex
$ npx phyll setup claude    # connect Phyll to Claude Code

Your account

The key stays in ~/.phyll on this computer. To use another computer, run login there.

$ npx phyll signup you@example.com    # create a free account
$ npx phyll login                     # connect this computer by allowing it in the browser
$ npx phyll login phyll_...           # or connect it with a key
$ npx phyll status                    # your plan and the reviews left
$ npx phyll account                   # open your account on the site, signed in
$ npx phyll logout                    # forget the key on this computer

Scan, free and with no account

An AI tell index from 0 to 100, lower is better, with each tell by file and line. It also runs in CI as a GitHub Action.

$ npx phyll scan                  # scan the current folder
$ npx phyll scan ./my-app         # scan another folder
$ npx phyll scan --format json    # the result as JSON, for scripts

Review and fix, in your agent

Type these in Codex or Claude Code, in your own words. The report lands in .phyll/reports, with a link.

> review my app at http://localhost:3000                          # a full review, as a first-time user
> review my app at http://localhost:3000 for small shop owners    # say who the users are
> fix the findings from the last Phyll review                     # the fixes keep your design

Claude Code plugin

Adds three commands to Claude Code and starts the connector by itself.

> /plugin marketplace add carlosphyll/phyll    # once
> /plugin install phyll@carlosphyll            # install the plugin
> /phyll:review http://localhost:3000          # review an app
> /phyll:fix top                               # fix the top findings, or UX-01 UX-03, or all
> /phyll:scan                                  # a quick scan of the project

Phyll Pro

Unlimited reviews. Checkout shows the price in your currency.

$ npx phyll pro        # subscribe
$ npx phyll billing    # change the card, see the invoices or cancel

Options: --server <address> for signup and login, --lang <code> for signup, --format json for scan.

$ npx phyll help       # every command
$ npx phyll version    # the version installed
$ npx phyll mcp        # the connector itself; your agent starts it for you