hippo

hippo — the project's hippocampus

hippo does not control you; it holds the memory — what you delegated, what was accepted or refuted, which of the user's instructions are still alive. The judgment is always yours.

Grammar

hippo init
hippo status [--inject]
hippo task add <type>/<slug> --title T [--notes N] [--deps a,b]
    [--status pending|active|done|dropped]
hippo task set <id> title|status|notes|deps <value>      # positional: no --flags
hippo task done <id> [--note N]
hippo task list [--status s1,s2] [--all] [--json]
hippo task show <id> [--json]
hippo task drop <id>
hippo log dispatch --id D --kind K --exec executor/model/effort --scope S
    [--task T] [--depth N] [--parent D]
hippo log outcome --ref <dispatch-id>|task:<task-id> --result accepted|revised|refuted|no-go|lost
    [--attr work|brief|harness] [--rework N] [--by executor/model] [--note N]
hippo log outcome --from-batch <journal> [--dry-run] < verdicts.jsonl
hippo log review --id R --base <sha> --source S --findings N
hippo log review-status --ref R --addressed full|partial|none [--at <sha>]
hippo log raw '<json>'
hippo log tail [-n N] [--ev TYPE]
hippo directive add --text T [--id kebab-id] [--audience main|executor|all]
    [--state active|withdrawn|expired]
hippo directive list [--active] [--json]
hippo directive withdraw <id>
hippo prior show
hippo prior distill [--days N]
hippo dispatch --kind K --scope S [--task T] [--depth N] [--fast] [--] <codex exec args…>
hippo dispatch --batch <manifest.yaml> [--dry-run | --entry <id>]  # --entry: the Workflow face's call, never typed
hippo dispatch --watch <dispatch-id|batch-id> [--for SECONDS]
# a bare noun reads: task → list, log → tail, directive → list, prior → show

When

• Work will outlive this turn → task add; task done when it ships.
• A delegation gets a verdict → log outcome (--ref task:<id> finds its open dispatch).
• The user rules → directive add; re-add the same --id to change it, withdraw when done, --audience main when a lane never needs it. A rule for the next answer only is not one.
• An external review arrives → log review; its findings dealt with → log review-status.
• Before routing a delegation → prior.
• Codex lanes → dispatch (--batch for many, --watch <id> to wait); see /hippo:dispatch.
• A subagent or Workflow run (Codex: a spawn_agent child): no call; the scribe records it and your verdict, in Claude Code as ag-<agentId> or, once a Workflow ends, ag-wf_… (Run ID, not Task ID): name it in its verdict. One task id in its brief links it.
• Lost your place → status.