specstride

// install

Install

Only what works today has commands. Every command below was run by hand, exactly as written, on the date shown under it. Plugins that aren't out yet say so.

git clone

Available

Clone the CLI and run the bundled three-phase Spec Kit example end to end. Claude writes the code; a critic signs off each phase.

Needs

  • Linux, Bash, git and Python 3.13 (the CLI uses the standard library only)
  • The Claude Code CLI, logged in, for the proposer
  • ANTHROPIC_API_KEY in the environment for the claude critic, which calls the API directly (or set SPECSTRIDE_CRITIC to codex with OPENAI_API_KEY, or to dsh)
git clone
git clone https://github.com/mairp/specstride && cd specstride
mkdir -p /tmp/demo/specs/001-greeting && cp examples/speckit-tasks.example.md /tmp/demo/specs/001-greeting/tasks.md
SPECSTRIDE_PROPOSER=claude SPECSTRIDE_CRITIC=claude ./specstride run -w /tmp/demo --verification off

Follow it from a second terminal with ./specstride watch -w /tmp/demo. --verification off skips the test-plan gate, which wants a test command the empty demo directory doesn't have yet; leave it on in a real project.

Commands last run as shown: 2026-10-01

shell function

Available

Keep one checkout and get a specstride command everywhere. The script owns its routing, so the function is only a pointer. Add these two lines to ~/.bashrc or ~/.zshrc.

Needs

  • A clone of the repository (the previous tab), here at ~/specstride
shell function
export SPECSTRIDE_HOME="$HOME/specstride"
specstride() { "$SPECSTRIDE_HOME/specstride" "$@"; }
# then, from any directory
specstride status -w /tmp/demo

specstride run, watch, events, verdicts, stop and resume all go through the same command.

Commands last run as shown: 2026-10-01

reverse a codebase

Available

No spec yet? Inventory a codebase and see the five gated phases that would write its as-is Spec Kit feature. The dry run makes no model call and changes nothing.

Needs

  • A clone of the repository, as in the first tab
reverse a codebase
./specstride reverse ~/projects/foo --dry-run

Drop --dry-run to write specs/NNN-as-is-foo/ through the gated loop. It reads your source and never changes it.

Commands last run as shown: 2026-10-01

Claude Code plugin

In progress

specstride-run and specstride-reverse as Claude Code skills. Specified, and built after the TypeScript core it sits on. There is nothing to install yet.

Watch the repository on GitHub

dsh plugin

Planned

The same skills on dsh, in the second wave. Nothing to install yet.

Codex plugin

Planned

The same skills inside Codex. On the roadmap, not scheduled. Nothing to install yet.

After the first run