The ziv binary is the single entry point. This page mirrors ziv --help.
| Command |
Description |
ziv project new [dir] [--name <n>] [--no-scaffold] [--no-commit] |
Create a project (git + registration + zpi scaffold + seed commit) |
ziv project add [repoPath] [--name <n>] |
Register an existing repo as a project (adopted as-is) |
ziv project list |
List all registered projects (name, reachable, id, repo) |
ziv project rename [<id|name>] <new> |
Rename a project (the cwd project if no <id|name>) |
ziv project set-repo-path <id|name> <path> |
Re-anchor a moved project’s repo path |
ziv project delete <id|name> |
Unregister a project (the source repo is NOT deleted) |
| Command |
Description |
ziv workspace new --name <name> --agent <a> --goal <g> [--parent main|<name>] [--no-open] [--<agent-flag> <v>…] |
Create a workspace — an isolated worktree owned by one agent — and enter its session |
ziv workspace list |
List workspaces and their states |
ziv workspace archive <name> |
Archive a completed workspace (guarded: dirty worktree or running session refuses) |
ziv workspace abort-complete |
Unwind a stuck completion |
ziv workspace rename <name> <new> |
Rename a workspace |
ziv workspace delete <name> |
Delete a workspace |
The registered agents are prover, paper-to-package, and zpi-agent; agent-specific options
pass through as --<agent-flag> <value>.
| Command |
Description |
ziv open <name> |
Re-enter workspace <name> in a new conversation |
ziv resume <name> |
Continue the last conversation in workspace <name> |
ziv agent [--workspace <name>] [--resume] |
Launch the general zpi-agent session (the cwd’s package, or workspace <name>) |
Inside a session: /login <provider> authenticates, /model picks a model, /wrap-up closes
out a workspace session.
| Command |
Description |
ziv check [path] |
Mechanically validate a zpi package |
ziv build [path] |
Ship gate: compile + write ziv.manifest.json |
| Command |
Description |
ziv --version, ziv -v |
Print the version |
ziv --help, ziv -h |
Print help |
