$ 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.