Reference

The easycode CLI

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

Generated from the codeView as Markdown

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.

CommandArgumentsWhat it does
easycode devDev server on http://127.0.0.1:4738, opens the browser.
easycode startProduction 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 listList 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 runnerRun 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 loginSign in to EASYCODE_API_URL in the browser; the token goes to <state>/session-token.

Environment variables

VariableWhat it does
EASYCODE_NO_OPENSet EASYCODE_NO_OPEN=1 to keep the browser closed.
EASYCODE_PORTEASYCODE_PORT and EASYCODE_RUNNER_PORT move the app and runner off 4738 and 4739.
EASYCODE_RUNNER_PORTEASYCODE_PORT and EASYCODE_RUNNER_PORT move the app and runner off 4738 and 4739.
EASYCODE_ROOTEASYCODE_ROOT points the app at another workspace.

Something wrong or missing? Suggest a change