sharpy cheatsheet /commands

v2 updated 2026-04-18 analysis → proposal → source repo
click any command for full spec · ← → to navigate · esc to close

lifecycle 3

  • /killRW-conv
    2–6
    Gated death. Auto-/reaps UNPERSISTED with defaults. Halts on low-conf; stays ALIVE.
  • /kill!RW-conv
    2–4
    Force-kill. Runs /rite for the record, then DEAD regardless.
  • /resurrectRW-conv
    3–6
    Turn a DEAD conversation back into work via /spawn; self-delete corpse.
    alias: /undead

persistence 2

  • /riteRO
    2–8
    End-of-convo persistence check. Auto-light (2–3) on clean convos, full (6–8) otherwise. --deep forces full.
  • /reapRW-project/repo/mem
    N×1–3
    Resolve NEEDS_AGENT / UNPERSISTED with sane defaults. Asks only when confidence <60% or action destructive.

maintenance 7

  • /compactRW-mem
    4–8
    Merge staging into long-term files; dedupe memory entries via RLA.
  • /transcendRW-mem
    15–30
    Schema migration, memory rebuild, file cleanup. Two-phase: agent kills stale convos, user runs console deletes.
  • /inhaleRW-project+mem
    8–12
    Pull canonical agent-*.md from GH, apply project profile (omissions/stubs), refresh memory, check PATs.
  • /auditRO
    8–12
    Hygiene sweep: PAT health, repo HEAD sync, file counts, memory age. Read-only; reports findings.
  • /commandsRO
    4–6
    Structural integrity + grouped listing. --profile annotates per-project filters.
  • /profileRW-project
    2–5
    View/edit the project's agent-project-profile.md. Subcommands: omit / stub / clear / reset.
  • /trustRO-mode
    mode
    Explicit delegation mode. Agent picks defaults, acts, reports. Self-tracks tool calls / caves / elapsed; checkpoints every ~10 calls; self-rescues past ~25. Final reply includes a telemetry block. Scope: current convo. Hard rules still apply.

orchestration 5

  • /spawnRW-project
    1–2
    Create a NEW project conversation and hand off next steps. Returns URL + dust -a sharpy -c reconnect. /spawn /<cmd> spawns then runs the command.
  • /fanoutRW-project
    N×5+3
    Parallel workers. Each must dual-cave (anthro + open). Harvest via /fanout harvest RUN-XXXX.
  • /caveRO
    2–6
    Subagent consult IN THIS convo. /cave anthro, /cave open, /cave both. Pin token alone = error; -- marks end-of-options.
  • /meteoriteRW-project
    N×5+3
    Alias: /fanout rite --since=90. Project-wide persistence scan. --self to include current convo.
  • /protocolRW-project/repo/mem
    varies
    Resume project-specific multi-step execution from its bootstrap file. Steps requiring verification run dual-cave. Omit via profile when no protocol file exists.

review 1

  • /reviewRW-project
    10–25/PR
    GH PR review: fetch comments via HTML-pipeline XHR, dual-cave reply drafts per worker, harvester assembles PENDING review. Syntax: /review #5, /review chain.

aliases & triggers

RO — read only RW-conv — conversation state RW-project — project files/convos RW-mem — agent memory RW-project/repo/mem — everything RW-project+mem — two scopes