zcode-cli

ZCode CLI

ZCode's Agent CLI provides an interactive terminal and non-interactive task execution. It is part of this pnpm workspace; build it from the repository root with the Node and pnpm versions in mise.toml.

pnpm install --frozen-lockfile
pnpm --filter @zcode/cli... build
node apps/zcode-cli/packages/cli/dist/zcode.cjs doctor --json

The default artifact is a Node.js bundle with adjacent runtime resources. SEA packaging is optional. The Agent CLI differs from the root distribution launcher, which also supports Web startup.

See the CLI usage guide (中文) for setup, model configuration, permissions, sessions, MCP, skills, hooks, plugins, and reproducible batch tasks. The guide distinguishes current source behavior from older binaries and documents its verification limits.

Useful entry points:

• Quick start and packaging
• Model and runtime configuration
• Plugin development
• Hooks and workspace trust
• Batch tasks and trajectory capture
• Design specifications
• Contributor instructions

Run pnpm --filter @zcode/cli dev for source development. CLI code validation follows the contributor instructions; CLI tests are separate from the root unit-test suite.