Command Reference
The full surface, from the live registry (shared/pulse/src/cli/help.ts). Inside the CLI, help prints this; help <command> gives deep help; examples gives 20+ copy-paste examples. Complexity-priced commands are marked 💠; everything else is free.
Onboarding & meta
| Command | What it does |
|---|---|
tutorial | Guided 7-step onboarding — account → machine → compute → verify → entangled state → SDK → build. Resumable. |
help [command] | Categorised help, or deep help for one command. |
examples | 20+ runnable examples across all categories. |
docs <topic> | Open the SDK page for a topic. |
doctor | Diagnose the install: origin health, clock drift (Zeqonds), auth, binary vs the origin's sha256 pin, conformance surface. Every ✗ carries its remedy. |
hello / hello universe 💠 | Real one-shot demo / three operators across QM, NM, GR. |
version | CLI version + framework constants. |
clear · history [clear] · exit | Feed and session management. |
completion <zsh|bash> | Shell-completion script for the native CLI. |
update | Re-run the sha256-pinned installer. |
Identity & credits
| Command | What it does |
|---|---|
signup "<phrase>" [name] | Create an account from the terminal — derives your account equation from the phrase (≥4 meaningful words), registers only its hash, mints ZID + machine + API key. Equation shown once. |
signin <ZID> ["equation"] | Sign in. Native: omit the equation for a hidden prompt (never echoed, never in history). |
whoami | Current ZID, machine, tier, ZEQ balance. |
credits / credits swap <btc|eth> <amt> / credits tally | Balances, swaps, the tally viewer. |
signout | End the session (machine survives). |
keys / keys mint <name> [scope] / keys revoke <id> | Developer API keys — raw key shown once at mint. |
machine mint "<equation>" [name] | Spin up a NEW machine from an equation YOU supply (manual genesis). |
sdk | SDK quickstart wired to YOUR key + this origin — curl, JavaScript, Python, MCP, kernel skill, native install. |
The verification trio
| Command | What it does |
|---|---|
verify | The flagship — Ed25519 signature check + independent recompute on a CKO envelope. |
conformance | Fetch the content-hashed golden-vector corpus, have the node re-run every vector, bit-compare (IEEE-754 identity). |
chain verify | Proof-of-Elapsed-Zeqonds. Native: the canonical zero-dependency offline verifier (VDF spine, elapsed Zeqonds, binding, hash links, Ed25519). Browser: the hash-link leg + pointer to the full check. |
Pulse / Zeqond
pulse · pulse clock (live ticking) · pulse status · time — the 1.287 Hz system clock surface.
Kernel & operators
| Command | What it does |
|---|---|
compute <op> [k=v ...] 💠 | Run an operator → signed CKO envelope. KO42 carrier auto-applied. --json for machines, --dry-run for a cost-only preview. |
operators count / list [domain] / search <q> / show <id> / categories | Browse the 1,500+ catalogued operators across 64 domains. |
families / families show <slug> | The 8 operator families. |
Agents, skills, contracts
| Command | What it does |
|---|---|
agents / agents spawn "<directive>" 💠 / agents tick <id> 💠 / agents kill <id> / agents mesh <id> | LLM hyper-agents on your machine. |
skills / skills synthesise "<intent>" 💠 | LLM-synthesised mini-procedures. |
contract list/show/fire-now 💠/pause/resume/dry-run/preview/next-fires/export/deploy 💠/import/events | State contracts — deploy, fire, audit. |
Entangled state, APIs, site
| Command | What it does |
|---|---|
state head / state audit [--limit N] / state public / state explore | Your machine's hash-linked entangled state. |
apis / apis add <name> <url> / apis test <id> / apis remove <id> | External APIs callable from contracts and agents. |
site list/deploy/get/unpublish · prd show/edit/push | Publish live pages; manage the PRD the build agent reads. |
api / api show <group> / api search <q> / api total | Browse the node's endpoint surface. |
protocols / protocols domains / protocols show <n> / protocols search <q> | The protocol chapters. |
skill / skill prompt/md/manifest/install <client>/verify | The kernel skill any LLM client can boot from. |
System & ZSC
| Command | What it does |
|---|---|
health · oracle [history N] · web <url> · theme [name] | Health probe, Transparency Oracle, proxied fetch, themes. |
context / context list/info/set/rotate/grant/revoke/audit/delete | ZSC — the encrypted secret vault that replaces .env. Every read lands an entangled-state audit row. |
Profiles (native)
profile lists saved { key, origin } sets; profile add attaches a key you saved; profile use <name> switches the active identity. signup auto-saves the fresh identity as the default profile.