The CLI

cli/ujima.py · 1,718 lines · zero dependencies · Python 3.9+
$ python ujima.py --help
usage: ujima [-h] [--root ROOT] [--as AS_AGENT] [--version]
             {init,agent,whoami,send,reply,inbox,read,archive,status,
              log,ledger,checkpoint,brief,poll,convene,sweep,doctor,
              render,lock,unlock}
             ...

Ujima v1 - deterministic multi-agent coordination core

positional arguments:
  init          create a new workspace
  agent         manage agents
  whoami        print resolved agent identity
  send          send a message (atomic, instant)
  reply         reply within a thread
  inbox         list your messages
  read          print a message (marks it read)
  archive       move an inbox message to archive
  status        team state
  log           append a ledger note (<=300 chars)
  ledger        print recent ledger notes
  checkpoint    write the next checkpoint (stdin or --file)
  brief         the session boot digest (replaces boot rituals)
  poll          adaptive check-in cadence (short start, backoff
                on empty, reset on work)
  convene       D.O.P.E. self-organizing dispatch
                (docs/07-CONVENE-DOPE.md)
  sweep         housekeeping + escalations (run from a scheduler)
  doctor        validate the workspace (exit 1 on problems)
  render        regenerate STATUS.md / LEDGER.md views
  lock          lock a shared/ file (TTL 10 min)
  unlock        release a shared/ file lock

options:
  -h, --help       show this help message and exit
  --root ROOT      workspace root (default: walk
                  up from cwd)
  --as AS_AGENT    act as this agent (default:
                  $UJIMA_AGENT)
  --version        show program's version number

The "seven verbs" story

briefreplaces the 11-step boot sequence
send/replydirectives folder, mailroom pipeline
inbox/read/archivemanual inbox scanning + READ-BY edits
status setlock→edit→release dance on STATUS.md
loglock→append→release dance on LEDGER.md
checkpointmanual checkpoint writing at rotation
sweep + doctorJorin's 20-min sweeps + a health check v1/v2 never had
Discrepancy, per the fidelity rule: README.md and skills/ujima-core/SKILL.md both teach "the seven verbs." The shipped CLI has 19 subcommands. agent, whoami, init, ledger, render, lock/unlock, poll and the entire convene family exist in code and are absent from the seven-verb pitch. Shipped code wins — this gallery lists all 19 on the Verbs page.