# The easycode CLI

Every easycode command, its arguments and the environment variables it reads, from the code.

The `easycode` CLI runs the EasyCode app from a checkout: the web UI and the local runner beside it. This table is generated from the CLI's own help text.

| Command | Arguments | What it does |
| --- | --- | --- |
| `easycode dev` |  | Dev server on http://127.0.0.1:4738, opens the browser. |
| `easycode start` |  | Production build, then serve it (fast reads), opens the browser. |
| `easycode check` | `[--no-build] [path]` | Render-check every artifact (or those under path). |
| `easycode new` | `<folder> <slug> [type]` | Scaffold an artifact. |
| `easycode list` |  | List artifacts from artifacts/index.json. |
| `easycode open` | `[path] [--space id]` | Register a folder (default: where you ran this) and open it in the app. |
| `easycode runner` |  | Run only the local runner (terminals, assistant sessions). |
| `easycode cleanup` | `[--force]` | Delete EasyCode's hidden refs and orphan isolated worktrees. |
| `easycode matrix` | `[--harness h] [--rung r]` | Live smoke run of each driver; report in diagnostics. |
| `easycode library import` | `<checkout> --org <slug> [--propose]` | Post a kit checkout's skills, agents, guides and mcp servers to your org. |
| `easycode artifacts import` | `[dir] --org <slug> [--product <slug>] [--dry-run]` | Save each page folder as one HTML file and publish it to your org. |
| `easycode knowledge import` | `<checkout> --org <slug>` | Post a checkout's repo contexts and product maps to your org. |
| `easycode design render import` | `<dir> --org <slug> --system <slug> --release <version\|id>` | Upload a render catalogue to a release. |
| `easycode design note` | `<release link> --file <path>` | Post an upgrade note to a release as a draft. |
| `easycode specs import` | `<path> --org <slug> --product <slug> [--dry-run]` | Import local cycles. |
| `easycode login` |  | Sign in to EASYCODE_API_URL in the browser; the token goes to <state>/session-token. |

## Environment variables

| Variable | What it does |
| --- | --- |
| `EASYCODE_NO_OPEN` | Set EASYCODE_NO_OPEN=1 to keep the browser closed. |
| `EASYCODE_PORT` | EASYCODE_PORT and EASYCODE_RUNNER_PORT move the app and runner off 4738 and 4739. |
| `EASYCODE_RUNNER_PORT` | EASYCODE_PORT and EASYCODE_RUNNER_PORT move the app and runner off 4738 and 4739. |
| `EASYCODE_ROOT` | EASYCODE_ROOT points the app at another workspace. |
