| Command | Aliases | What | DoD |
|---|---|---|---|
| ~i | ~I, ~inspect | Inspect a repo, codebase, or URL | gate |
| ~p | ~P, ~plan | Plan work — intent, scope, approach | gate |
| ~pu | ~PU | Plan as user story — As a..., I want..., So that... | gate |
| ~pt | ~PT | Plan test strategy | gate |
| ~e | ~E, ~estimate | Size a plan into Fibonacci boards (3 or 5 pts) | gate |
| ~a | ~A, ~add | Add something new + immediate review | gate |
| ~u | ~U, ~update | Update existing code or feature + review | gate |
| ~d | ~D, ~delete | Remove code, feature, or files + review | gate |
| ~f | ~F, ~fix | Diagnose + fix + write test + review | gate |
| ~b | ~B, ~build | Build from board or argument. Completes entire board | gate |
| ~bt | ~BT | Build tests for a feature + review | gate |
| ~t | ~T, ~test | Test current work, fix what's broken | gate |
| ~s | ~S, ~ship | Commit, push, deploy, ship report | chain-final |
| ~brief | ~Brief | Avatar video briefing from ship report | gate |
| ~demo | ~Demo | Demo, review, or refactor | gate |
| ~r | ~R, ~retro | Retrospect on recent work | chain-final |
| ~n | ~N, ~new | Create a new project repo | gate |
| ~l | ~L, ~load | Load a repo into Be's working context | exempt |
| ~li | ~LI, ~list | List all local + remote Be projects | exempt |
| ~ul | ~UL, ~unload | Close out a project — housekeep + report | gate |
| ~m | ~M, ~mcp | Manage MCP servers | exempt |
| ~monitor | ~M | Watch a deploy | exempt |
| ~transfer | Generate project handoff manifest | gate | |
| ~tag | ~TAG | Tag anything — triples, searchable, git-managed | exempt |
| ~config | ~Config | Runtime settings — reports, chains, display modes | exempt |
| ~cr | ~CR, ~crash | Recover from a crash mid-command | exempt |
| ~jc | ~JC | Joey's take — 40+ years of advice | exempt |
| ~h | ~H, ~help | Display help — dynamic Latest block (top 3 from telemetry) + commands + Flow/Chains + Discipline (DoR/DoD/Proposal) + quote | exempt |
Commands outside / run once, left to right. Commands inside / / loop until the exit condition is met: board exhausted, tests pass, nothing to fix.
~chain-reaction new — interview mode, build a chain interactively.
~<NAME> — shorthand to run any named chain (e.g. ~GO).
Every tilde command that produces an artifact must pass all 7 items before the command is considered complete.
be/telemetry.json entry has a non-null commit field. Backfilled in the same commit.{item} · pts · ~cmd ✅ (abc1234).be/ with correct datetime filename.be/index.html has an entry linking to the new report.git push succeeded. Work exists on origin, not just locally.Chain-final commands (~s, ~r) must also pass:
If any DoD item fails, the command is not Done. Fix in-place and re-verify. The gate holds.
~h, ~li, ~l, ~cr, ~jc, ~m, ~tag — utility commands, inline output only, no artifacts.
Before the first edit of a session, read and verify:
be/board.md. Know what's Done, In Progress, Ready. Don't touch Done items.~b without a following ~s, flag it.3 file reads. Takes seconds. Prevents cross-session work loss.
Every tilde command (except ~h) follows this chain:
Every item is a triple: {what, verb, context}
Verb maps to a tilde command:
| "add to" | ~a |
| "update with" | ~u |
| "remove from" | ~d |
| "fix in" | ~f |
| "plan tests for" | ~pt |
Fibonacci only: 3 or 5 points per item. A 5 is something a college student can do in one night, complete and perfect. Boards total 13–21 points.
Ready → In Progress → Done
Done format: {item} · pts · ~cmd ✅ (commit-hash)
Version is 0. Always. No semantic versions. No major.minor.patch.
Every change is a revision: git rev-list --count HEAD
Display: v0 · rN · YYYY-MM-DD · pts
Total points from be/board.md. Computed by be/pts.py at launch.
#111111#1A1A1A#6FC3DF (tron blue)✓ Item (detail) or ✗ Item (reason)project/
be/
index.html ← auto-generated artifact index
board.md ← kanban state
docs/ ← command specs + conventions (lazy-loaded)
plans/ ← ~p, ~e, ~i outputs
builds/ ← ~b, ~a, ~u, ~d, ~f outputs
tests/ ← ~t, ~bt outputs
ships/ ← ~s outputs
retros/ ← ~demo, ~retro outputs
transfers/ ← ~transfer outputs
Every command (except ~h) logs to be/telemetry.json:
{description, verb, project}Rolling 100 entries max. Viewer at be/telemetry.html.
Verb mapping: ~a → "added to", ~b → "built in", ~u → "updated in", ~d → "deleted from", ~f → "fixed in", ~s → "shipped from", ~p → "planned for", ~e → "estimated for", ~i → "inspected in", ~t → "tested in", ~r → "retro'd in", ~tag → "tagged in".