Commands

Every command works without a terminal, so hashd can be scripted or driven by an agent. Commands that ask for confirmation accept -y. Run hashd <command> --help for every flag.

Plan and stories

Command What it does
hashd plan Discover stories from REQS.md and save suggestions
hashd plan list List current suggestions
hashd plan claim <n> Turn a suggestion into a story
hashd plan story "title" Create a feature story directly
hashd plan bug "title" Create a bug story directly
hashd story edit STORY-xxx -f "..." Hand a story to the AI editor
hashd story edit-ac / delete-ac / descope-ac / rescope-ac Change individual acceptance criteria
hashd approve STORY-xxx Accept a story

Run and gate

Command What it does
hashd run <id> [--loop] Run a workstream, or create one from a story
hashd watch [id] Open the live terminal dashboard
hashd show <id> Show a story or workstream
hashd list [--mine] List stories and workstreams
hashd log <id> Show a workstream's timeline
hashd diff <id> Show a workstream's diff
hashd review <id> Show the current review
hashd approve <id> Approve at a gate
hashd reject <id> -f "..." Reject with guidance
hashd reset <id> Keep the plan, redo the work from a clean baseline
hashd replan <id> -f "..." Regenerate the plan
hashd answer list / hashd answer <id> "..." See and answer agent clarifications
hashd conflicts [id] Show file overlap with other workstreams

Merge

Command What it does
hashd merge <id> Run the merge gate and merge to main
hashd merge <id> --pr Merge through a pull request on your forge
hashd pr create <id> Open a pull request for external review
hashd pr feedback <id> Read pull-request review comments

Lineage

Command What it does
hashd lineage <file|sha|STORY-xxx> Trace code back to its requirement and decisions
hashd lineage export <sha|STORY-xxx> --format slsa|in-toto Export attestations
hashd lineage verify Verify the commit hash chain

Projects and setup

Command What it does
hashd project add <path> Register a repository
hashd project list / use / show Manage and select projects
hashd project config list / set / diff View and change project settings
hashd project reqs / hashd project spec Show or edit REQS.md and SPEC.md through the server
hashd agents Installed agents and credential health
hashd directives View and edit directives

Operations

Command What it does
hashd doctor Diagnose your setup
hashd status Server, health and identity
hashd restart Restart local services, waiting for running work to reach a stopping point
hashd search <query> Full-text search across stories, events, reviews and chat
hashd chat [id] Pair-programming chat with project, story or workstream context