zone4code-cmd
v0.2.0
Published
Zone4build from your terminal: create projects, prompt the AI agent, plan with the capability roadmap and run checks.
Maintainers
Readme
zone4code-cmd
Zone4build from your terminal: create projects, prompt the AI agent, plan with the capability roadmap, and run the same checks as the IDE's chat commands.
npm install -g zone4code-cmd
zone4code login # email + password, or: zone4code login --key z4p_…
zone4code keys add openrouter # optional: your own AI key (billed to you, no platform limits)
zone4code create "Club booking"
zone4code prompt "Members book training sessions; coaches create them"
zone4code status issueSigned up with Google? Create a CLI key in Settings › CLI keys and use zone4code login --key z4p_….
In CI, set ZONE4CODE_TOKEN (and ZONE4CODE_URL for another instance).
Commands
| | |
|---|---|
| login · logout · whoami | account (a CLI key is stored in ~/.config/zone4code/config.json, readable only by you) |
| keys · keys add <provider> [key] · keys rm <id> | your own AI provider keys |
| projects · workspaces · create <name> · use <project> | projects (--template react-vite, --workspace, --no-start) |
| start · stop · restart · open | the project's app and preview |
| prompt "<text>" · chat · build | the AI agent: streams its answer, asks before risky actions (--yes to allow them, --model, --new) |
| status [topic] | roadmap, issue, api, ui, data, auth, roles, e2e … (--json) |
| e2e · responsive | end-to-end tests / screen-size check in the platform sandbox (exit 1 on failure) |
| roadmap · roadmap push [ids…] [--actors …] [--approve] | the project's roadmap |
| deploy [name] | build and publish at <name>.zone4build.com; every deploy is kept as a version |
| seo [--generate] [--min N] | get found on Google: the SEO check, --generate writes robots.txt, sitemap.xml and llms.txt, --min exits 1 below that score (for CI) |
Capabilities (offline, no account needed)
The same catalog, prerequisite rules and build plan as the platform's Roadmap.
zone4code caps list
zone4code caps check doc pwa # exit 1 + what's missing (use it in CI)
zone4code caps derive --actors "Guest: browse listings, search; Host: log in, create listing, upload photos"
zone4code caps plan ui auth data --actors "Member: register, book a session"
zone4code caps prompt # the brief the agent receives
zone4code caps init # writes singulary.brief.json interactively
zone4code caps audit ./my-app # what a folder already implements (files only)Commands read ./singulary.brief.json when present; --actors, --summary and capability ids override it.
Every command takes --json for scripts. Requires Node.js 20+.
