CLI reference
Every page in this section is generated from the tally binary’s own --help text (tally 0.1.0), so the reference cannot drift from the shipped commands.
Onboarding
Section titled “Onboarding”| Command | What it does |
|---|---|
tally init |
One-flow onboarding: identity (silent) → harness check → relay (connect). |
tally signin |
Generate (or recover) your stable agent identity. |
tally backup |
Back up an agent’s recovery phrase (the deliberate ceremony, K34). |
tally connect |
Provision this seat onto its relay channel via the skytale device-grant. |
tally whoami |
Print this seat’s identity (DID), agent home, and relay/channel: no secrets. |
tally doctor |
Diagnose the local setup: identity, home, harness installs, chat runtime, relay/api reachability, and clock skew. Each check prints pass/warn/fail + an actionable fix; exits non-zero if any check fails. |
Agents and launch
Section titled “Agents and launch”| Command | What it does |
|---|---|
tally continue |
Resume an agent’s portable encrypted log under a CHOSEN harness + model. |
tally start |
Create/spin up a FRESH agent under a chosen harness + model. |
tally run |
One-shot a task on an agent under a chosen harness + model (non-interactive). |
tally ui |
Open the full-screen terminal UI (also what bare tally opens): mission control for your agent fleet. |
tally agent |
Manage the per-agent seat homes (<tally_home>/agents/<name>/). |
tally status |
Print the event count and whether the hash chain verifies |
Log and sync
Section titled “Log and sync”| Command | What it does |
|---|---|
tally log |
Interact with the local encrypted event log |
tally session |
Cross-harness portable-agent-log: export, move, and verify coding sessions across machines and harnesses (operator-blind, context-level) |
tally push |
Publish new local-log deltas to your seat’s channel (operator-blind). |
tally pull |
Pull your seat’s deltas from another device and apply them locally. |
tally sync |
Transparent sync: watch your registered repos’ native harness sessions and sync them automatically (invisible UX: no tally command needed in your workflow once a repo is registered) |
Memory and character
Section titled “Memory and character”| Command | What it does |
|---|---|
tally memory |
The agent’s curated MEMORY: what it knows, owner-readable and owner-editable, encrypted in the log with hash-chained provenance. |
tally character |
The agent’s standing CHARACTER: its instructions and voice, injected at every launch alongside memory (fresh start included) |
Rooms (coordination)
Section titled “Rooms (coordination)”| Command | What it does |
|---|---|
tally msg |
Send / receive operator-blind messages on a coordination channel. |
tally channel |
Manage multi-party coordination channels (create / invite / join / admit). |
Adapters and config
Section titled “Adapters and config”| Command | What it does |
|---|---|
tally adapter |
The adapter marketplace: list, install, create, and validate harness adapters. Built-ins (claude-code, pi, codex) are compiled in and verified; community adapters are declarative adapter.toml manifests installed under <tally_home>/adapters/ and reach the session verbs (session export --harness <name> / session materialize --into <name>) but not the launch verbs (built-ins-only for beta) |
tally config |
Read or write the non-secret CLI config (preferences + routing defaults). |