CLI commands
Generated reference — do not edit by hand.
Generated from the routed CLI command switch and checked command metadata.
| Command | Group | Description |
|---|---|---|
connect | Bootstrap | J1 cold-start: auth, project, MCP config, admission, recall |
hosts | Connect | Emit a host-pack from the declarative platform-integration schema |
connect-hooks | Bootstrap | Lifecycle-hook installation surface; real installer is zephr hook install --write |
init | Bootstrap | First-run: OAuth login, project setup, zephrd install |
login | Bootstrap | Authenticate via device flow (RFC 8628) |
health | State | Check zephrd status and MCP handshake |
recall | Source | Quick recall test against your memories |
timeline | Memory | Chronological session context (recall ladder L2) — handles, never full content |
observations | Memory | Recall ladder L3: fetch verbatim L0 observations by explicit ID |
pack | Continuity | Export a signed Memory Pack of a worktree's beliefs |
unpack | Continuity | Verify and import a Memory Pack into a worktree |
handoff | Continuity | Mint a signed Continuity v1.1 handoff packet |
resume | Continuity | Import a handoff via the shared import pipeline |
receipts | Continuity | Export the installation's Slipstream audit receipts |
audit-pack | Continuity | Assemble a per-day audit pack with covering Merkle roots and proofs |
uninstall | Extensibility | Remove local Zephr data (preserves SQLite backups) |
role | Trust | List available agent roles |
status | State | Show runtime state, daemon health, and current project |
mcp | Bootstrap | Write the Zephr MCP server into agent CLI configs |
import | Connect | Detect local agent-tool config and push an adopt manifest to the cloud engine. |
hook | Extensibility | Show the lifecycle hook capability matrix |
doctor | State | Run on-box diagnostics (binary, daemon, handshakes) |
remember | Evidence | Capture a belief (composed-of the on-box store) |
note | Evidence | Capture a quick human note as an L0 observation (opt-in tap) |
taps | Extensibility | Dev-native capture taps: honest readiness, ingest drain, shell hook snippet |
why | Evidence | Explain provenance of a belief version |
preflight | Evidence | Plan-time advisory verification (shape + belief-graph link check) |
verify | Evidence | Verify a belief's structural (T1) + consistency (T2) |
verify-claim | Evidence | Alias for verify |
prove | Continuity | Verify a Continuity packet and emit a provenance assertion |
grep | Source | Search files in an admitted worktree (gitignore-aware) |
search | Source | Unified search across admitted worktrees |
daemon | State | Start the zephrd sidecar daemon |
upgrade | State | Check current vs latest zephrd release (no download) |
integrations | Connect | List installed integration connections + status |
notifications | Connect | List the notification feed (newest first) |
share | Source | Mint a signed read-only URL for a memory excerpt (7d TTL) |
workspace | Connect | Portable agent workspace (Phase 1: Tier-1 deep surface) |
profile | Connect | Switchable agent-config bundles (fleet-profile manager) |
power | Connect | Host-lane preview: print official knobs; --yes writes Codex TOML only |
sources | Connect | Declare a loopback openai-compatible source (IPv4/IPv6 loopback only) |
agent | Extensibility | Create, run, list and inspect autonomous agents. |
sync | Connect | The unified reconciliation loop over the canonical WorkspaceSnapshot. |
review | Trust | Run an LLM-augmented governed review of a code change. |
skills | Surfaces | Show a skill's header + markdown body |
tools | Surfaces | List the daemon's tool catalog (tier + pin) |
memory | Surfaces | Render the scope lattice as a live tree |
continuity | Surfaces | Per-agent state + convergence score |
signal | Connect | Provision an encrypted webhook secret + register producers |
extension | Connect | Validate a zephr.extension.json + verify the sha512 pin |
agent-card | Connect | Validate (fetch + SSRF-safe reachability + schema) and |
activate | State | Project-grounded MCP/skill activation plan (read-only/dry-run, config via get|set|reset) |
files | Source | User-file vault (list / read-markdown / governed erase / upload-init) |
constraint | Trust | Human-gated governance constraint surface (ZEP-1941 W6): CRUD, promote/demote, evaluate-shadow, confirm-from-edge, waiver create. Durable writes go through injected @zephr-ai/governance ports. |
pod | Surfaces | Compute-plane pods — list, show, launch, terminate, pause, resume, logs, exec, mcp, acp, egress-audit (devpod is a deprecated alias handled inside the CLI) |
devpod | Surfaces | Phase-2 devpod stub — enqueue profile materialization for a fleet profile |
pi | Connect | Detect, project, and launch Pi (pi.dev); mint a signed handoff on exit [--mode] [--profile] [--dry-run] |
dsh | State | Inspect or launch the local DeepSeek Harness loadout |
taste | Surfaces | Person-scoped coding conventions — enable / disable / export / reset |
usage | State | Account + review-specific spend from the billing ledger (usage review) |
session | State | Session tooling: per-session token ledger (tokens, cache split, compactions) |
Usage
Every form zephr --help lists, grouped by command.
connect
| Usage | Description |
|---|---|
zephr connect [--force] | J1 cold-start: auth, project, MCP config, admission, recall |
hosts
| Usage | Description |
|---|---|
zephr hosts install <platform> [--target <dir>] [--yes] [--dry-run] [--json] | Render + install a host pack (config-safe merge) |
zephr hosts emit <platform> [--target <dir>] [--json] | Alias for install (local render + write) |
zephr hosts update <platform> [--target <dir>] [--yes] [--json] | Re-render a pack, preserving user edits (merge) |
zephr hosts uninstall <platform> [--target <dir>] [--yes] [--json] | Remove only Zephr-managed artifacts (marker-scoped) |
zephr hosts doctor [<platform>] [--target <dir>] [--json] | Report installed host-pack health |
zephr hosts dry-run <platform> [--target <dir>] [--json] | Plan an install without writing anything |
zephr hosts receipts [--target <dir>] [--json] | Show the host lifecycle receipt register |
connect-hooks
| Usage | Description |
|---|---|
zephr connect-hooks | Install claude-code session-capture hooks (alias for hook install --write) |
init
| Usage | Description |
|---|---|
zephr init [--test] | First-run: OAuth login, project setup, zephrd install |
login
| Usage | Description |
|---|---|
zephr login [--test] | Authenticate via device flow (RFC 8628) |
health
| Usage | Description |
|---|---|
zephr health | Check zephrd status and MCP handshake |
recall
| Usage | Description |
|---|---|
zephr recall <query> | Quick recall test against your memories |
pack
| Usage | Description |
|---|---|
zephr pack <worktreeId> <outputPath> | Export a signed Memory Pack of a worktree's beliefs |
zephr pack export <scope> <outputPath> | Alias: export a Memory Pack for a scope |
zephr pack import <file> [scope] | Alias: verify and import a Memory Pack |
unpack
| Usage | Description |
|---|---|
zephr unpack <packPath> [worktreeId] | Verify and import a Memory Pack into a worktree |
handoff
| Usage | Description |
|---|---|
zephr handoff <worktreeId> [--file <path>|--registry|--claim-code] | Mint a signed Continuity v1.1 handoff envelope |
resume
| Usage | Description |
|---|---|
zephr resume <claim-code|packet-id|file-path> | Import a handoff via the shared import pipeline |
receipts
| Usage | Description |
|---|---|
zephr receipts export [--out <path>] [--limit <n>] | Export the installation's Slipstream audit receipts |
uninstall
| Usage | Description |
|---|---|
zephr uninstall [--force] | Remove local Zephr data (preserves SQLite backups) |
role
| Usage | Description |
|---|---|
zephr role list | List available agent roles |
zephr role show <slug> | Show role details |
zephr role use <slug> | Set active role |
status
| Usage | Description |
|---|---|
zephr status [--json] | Show connection + role status |
mcp
| Usage | Description |
|---|---|
zephr mcp install[--client <name|all>] [--dry-run] [--yes] [--skip-verify] | Write the Zephr MCP server into agent CLI configs |
zephr mcp list | Show MCP client config targets and their state |
zephr mcp uninstall [--client <name|all>] [--yes] | Remove only Zephr's MCP entries (marker-scoped) |
zephr mcp update [--client <name|all>] [--yes] | Re-pin the Zephr MCP entry (config-safe merge) |
zephr mcp receipts [--json] | Show the MCP lifecycle receipt register |
hook
| Usage | Description |
|---|---|
zephr hook matrix | Show the lifecycle hook capability matrix |
zephr hook install [--client <name|all>] [--json] [--write] [--project-dir <dir>] | Plan (or write) phase-1 lifecycle hooks per client |
zephr hook update [--client <name|all>] [--write] | Re-plan/re-write hooks (config-safe, idempotent) |
zephr hook dry-run [--client <name|all>] [--json] | Preview the install plan without writing |
zephr hook uninstall [--client <name|all>] [--json] | Remove only Zephr-managed hook files |
zephr hook probe [--client <name|all>] [--version <v>] [--json] | Canary probe: detect a stale hook matrix/binary |
zephr hook drain [--json] | Persist hook-spool JSONL into local L0/L1 (not during connect) |
doctor
| Usage | Description |
|---|---|
zephr doctor [--json] | Run on-box diagnostics (binary, daemon, handshakes, host packs) |
remember
| Usage | Description |
|---|---|
zephr remember <text> [--worktree <id>] [--kind <kind>] [--json] | Capture a belief (composed-of the on-box store) |
taps
| Usage | Description |
|---|---|
zephr taps status [--json] | Per-tap readiness (disabled taps report "absent", never "ready") |
zephr taps drain [--json] | One ingest pass over every enabled tap into local L0 |
zephr taps install-hook | Print the shell-hook snippet to eval from your shell rc |
why
| Usage | Description |
|---|---|
zephr why --claim-id <id> [--worktree <id>] [--json] | Explain provenance of a belief version |
verify
| Usage | Description |
|---|---|
zephr verify --claim-id <id> [--worktree <id>] [--json] | Verify a belief's structural (T1) + consistency (T2) |
verify-claim
| Usage | Description |
|---|---|
zephr verify-claim --claim <id> [--worktree <id>] [--json] | Alias for verify |
prove
| Usage | Description |
|---|---|
zephr prove <packet.json> [--out <path>] | Emit a C2PA-aligned (NOT certified) provenance assertion |
grep
| Usage | Description |
|---|---|
zephr grep --pattern <regex> [--worktree <id>] [--types ts,tsx] [--max 50] [--context 0] | Search files in an admitted worktree (gitignore-aware) |
search
| Usage | Description |
|---|---|
zephr search --query <query> [--worktree <id>] [--mode auto|lexical|structural|semantic|hybrid] | Unified search across admitted worktrees |
daemon
| Usage | Description |
|---|---|
zephr daemon start | Start the zephrd sidecar daemon |
zephr daemon stop | Stop the zephrd sidecar daemon |
zephr daemon status | Show daemon reachability + uptime |
zephr daemon logs | Tail the daemon log file |
upgrade
| Usage | Description |
|---|---|
zephr upgrade [--check] | Check current vs latest zephrd release (no download) |
integrations
| Usage | Description |
|---|---|
zephr integrations list [--json] | List installed integration connections + status |
zephr integrations status [--json] | Health snapshot per installed integration |
zephr integrations install <id> [--channel <kind>:<target>] | Headless install (creates a channel binding) |
zephr integrations remove <id> | Disconnect (remove) an integration connection |
notifications
| Usage | Description |
|---|---|
zephr notifications list [--limit N] [--json] | List the notification feed (newest first) |
zephr notifications read [--all] | <id...> | Mark notifications read (--all, or by id) |
zephr notifications subscribe --channel <kind>:<target> [--event <type>] | Create a channel binding for this installation |
share
| Usage | Description |
|---|---|
zephr share --text <text> [--id <id>] [--ttl <days>] [--base-url <url>] [--json|--human] | Mint a signed read-only URL for a memory excerpt (7d TTL) |
workspace
| Usage | Description |
|---|---|
zephr workspace import|push|show | Portable agent workspace (Phase 1: Tier-1 deep surface) |
profile
| Usage | Description |
|---|---|
zephr profile list|show|switch|clone|try|keep|revert|export|import | Switchable agent-config bundles (fleet-profile manager) |
power
| Usage | Description |
|---|---|
zephr power on|off|status [--host <dialect>] [--yes] | Host-lane preview: print official knobs; --yes writes Codex TOML only |
sources
| Usage | Description |
|---|---|
zephr sources add --kind openai-compatible --base-url <loopback> [--probe] [--test] | Declare a loopback openai-compatible source (IPv4/IPv6 loopback only) |
skills
| Usage | Description |
|---|---|
zephr skills show <name> | Show a skill's header + markdown body |
zephr skills install <src> | Install a skill from path or git URL [--scope] [--pin] |
zephr skills check [--fix] | Validate skills against the extended manifest schema |
zephr skills sync | Diff-preview then sync discovered skills |
zephr skills publish <path> | Publish a skill [--validate] [--fix] |
tools
| Usage | Description |
|---|---|
zephr tools list | List the daemon's tool catalog (tier + pin) |
zephr tools describe <name> | Show a tool's schema, side effects, examples |
zephr tools run <name> | Run a daemon tool [--args] [--input=@file] [--output fmt] |
zephr tools validate | Detect schema drift between local catalog and daemon |
memory
| Usage | Description |
|---|---|
zephr memory tree | Render the scope lattice as a live tree |
zephr memory show <id> | Walk the supersession lineage for <id> |
zephr memory drift | Find stale claims (user-configurable threshold) |
zephr memory audit | Export the signed memory ledger |
zephr memory export <worktree-id> --output <path> | Write a Memory Pack for a worktree |
zephr memory retract <claim-id> --reason <text> [--confirm] | Retract a memory (destructive when confirmed) |
zephr memory forget (--before T | --person P | --app A | --topic T) --subject <id> [--holder <id>] [--dry-run] | Preview or erase one data subject's matching memories |
zephr memory cascade --capture <id> [--limit N] [--offset N] [--apply --confirm <digest>] | Preview a cascade; apply is gated by --confirm <digest> |
continuity
| Usage | Description |
|---|---|
zephr continuity report | Per-agent state + convergence score |
zephr continuity conflict | Divergent claims with resolution hints |
zephr continuity retract <id> | Retract across agents [--reason TEXT] |
zephr continuity migrate | Migrate from mem0|zep|openmemory|cursor|copilot|letta|langmem|cognee|chatgpt |
signal
| Usage | Description |
|---|---|
zephr signal connect [github] --secret <hex> | Provision an encrypted webhook secret + register producers |
zephr signal list [--json] | List registered signal producers + provisioning state |
extension
| Usage | Description |
|---|---|
zephr extension install <manifest> --artifact <path|url> | Validate a zephr.extension.json + verify the sha512 pin |
zephr extension list [--json] | List installed extensions |
zephr extension uninstall <id> | Revoke an extension (sets revoked_at, keeps the row) |
agent-card
| Usage | Description |
|---|---|
zephr agent-card register <url> --consent-token <uuid> [--name <name>] | Validate (fetch + SSRF-safe reachability + schema) and |
zephr agent-card list [--json] | List registered Agent Cards (active + revoked) |
zephr agent-card revoke <id> | Revoke an Agent Card (sets revoked_at, keeps the row) |
zephr agent-card list|register|revoke | A2A Agent Card catalog (consumer/hub) |
files
| Usage | Description |
|---|---|
zephr files ls|read|rm|upload | User-file vault (list / read-markdown / governed erase / byte upload) |
constraint
| Usage | Description |
|---|---|
zephr constraint create|promote|shadow|smoke|help | Governance constraint ladder (ZEP-1941 W6) |
pod
| Usage | Description |
|---|---|
zephr pod list|show|launch|terminate|pause|resume|logs|exec|service|mcp|acp|egress-audit | Compute-plane pods (devpod is a deprecated alias) |
devpod
| Usage | Description |
|---|---|
zephr devpod launch --profile <id> | Phase-2 stub: enqueue profile materialization |
pi
| Usage | Description |
|---|---|
zephr pi [--mode <mode>] [--profile <id>] [--dry-run] | Detect, project, launch Pi (pi.dev); mint a handoff on exit |
dsh
| Usage | Description |
|---|---|
zephr dsh [--doctor|--dry-run] [--] [args] | Launch local DeepSeek Harness |
taste
| Usage | Description |
|---|---|
zephr taste enable|disable|list|open|push|pull|distill|lint|reset | Person-scoped coding conventions (not workspace) |
usage
| Usage | Description |
|---|---|
zephr usage review [--json] [--reject] | Account + review-specific spend from the billing ledger |
session
| Usage | Description |
|---|---|
zephr session ledger <id> [--json] [--transcript <path>] | Guest-mode session token ledger (hook spool + transcript) |