CLI Reference
The arcie command — init, dev, and build.
Zett ships a single binary, arcie, with three commands. In a scaffolded project
they're wired to npm run dev and npm run build.
arcie init
Scaffold a new agent project from a template.
arcie init [name] [--template <name>]| Argument / option | Default | Description |
|---|---|---|
[name] | — | Project directory to create. Omit to scaffold into the current directory. |
--template <name> | default | Which starter template to use. |
Refuses to overwrite an existing directory (when a name is given), copies the
template, sets the project's package.json name, and prints next steps.
arcie dev
Validate the agent and run it locally over HTTP.
arcie dev [-p <port>] [--agent-dir <path>]| Option | Default | Description |
|---|---|---|
-p, --port <port> | 3000 | Port to listen on. |
--agent-dir <path> | agent | Path to the agent directory. |
It runs discovery first: any
error-severity diagnostic stops the command (exit 1); warnings print and it
continues. Then it prints the model and tool count and serves POST / — send
{ "message": "…", "stream": true } to receive the event stream.
arcie build
Compile the agent into a production manifest.
arcie build [--agent-dir <path>] [--out-dir <path>]| Option | Default | Description |
|---|---|---|
--agent-dir <path> | agent | Path to the agent directory. |
--out-dir <path> | .arcie | Output directory for the manifest. |
Discovers and loads the agent, then writes <out-dir>/manifest.json — the artifact
Cencori runs. The manifest contains the agent config, instructions, the names
of every tools / skills / hooks / channels / schedules slot, each
subagents entry (its description and tools), the raw discovered slot lists,
and the resolved session and policy.
// .arcie/manifest.json (shape)
{
"config": { "model": "claude-sonnet-4-5", "name": "my-agent", "cencori": { } },
"instructions": "You are a helpful AI agent…",
"tools": ["get_weather"],
"skills": ["refund_policy"],
"hooks": [],
"channels": ["http"],
"schedules": ["daily_digest"],
"subagents": { "researcher": { "description": "…", "tools": [] } },
"session": { "maxTurns": 50 },
"policy": { "inputGuards": ["pii-redaction"] }
}