Command reference

Run commands from the HSSMSpine repository root unless noted otherwise.

Command	Purpose	Mutates state?
./setup.sh	Clone the five core repositories into repos/	Yes
./setup.sh --sibling	Clone repositories beside Spine	Yes
./claude.sh, ./codex.sh, ./cursor.sh	Synchronize context and launch an agent with discovered repositories	Local generated state
python3 scripts/sync_agent_config.py	Regenerate cross-editor instructions, agents, skills, and MCP config	Local generated state
python3 scripts/sync_agent_config.py --check	Verify generated agent configuration	No
./scripts/doctor.sh	Check tools and capability activation	No
python3 scripts/repo_state.py --include-spine --target main	Report repository and checkout risk as JSON	No
scripts/set_task_context.sh --new "Title"	Create and select local task context	Gitignored local state
scripts/worktree.sh add REPO BRANCH --new origin/main	Create an isolated checkout and branch	Yes
scripts/worktree.sh list [REPO]	List managed worktrees	No
scripts/worktree.sh rm REPO BRANCH	Remove a clean managed worktree	Yes
python3 scripts/drift_scoreboard.py render	Render the newest local freshness snapshot	No
python3 scripts/drift_scoreboard.py gather	Query live state and write a dated snapshot	Yes
./scripts/docs.sh build	Strictly build this site with the exact isolated docs requirements	Replaces site/
./scripts/docs.sh serve	Start a local documentation preview	No tracked state

Use --help on setup and Python entry points where available. Worktree and task-context examples are expanded in their corresponding how-to guides.