// install

Install

Commands are run by hand, exactly as written; the date under the path says when it was last verified that way.

Claude Code

Install the plugin in Claude Code, then take the ready-made example feature through its first run before pointing it at your own repository.

Needs

  • Linux. macOS is not verified: no Mac has run it.
  • Node 22+, git and Claude Code
  • A Spec Kit feature: a specs/NAME/ directory with a tasks.md, in a git repository (optionally with spec.md and plan.md beside it)
  • A test script in package.json
  • Your own subscription or API key for the models you choose
Claude Code
# in Claude Code
/plugin marketplace add mairp/specstride-plugin
/plugin install specstride@specstride-marketplace
# to try it on a ready-made feature first
git clone https://github.com/mairp/specstride-example
cd specstride-example
claude
# then say
Run Specstride on the feature in this repo.

On your own repository — any git repo with a specs/NAME/tasks.md and a test script in package.json — say the same sentence. Each approved phase becomes its own commit.

Commands last run as shown: 2026-11-05

dsh

Build the dsh host from a clone, install it with the engine's CLI from the tarball it pins, then put the three skills into your repository. Nothing is on npm yet.

Needs

  • Linux. macOS is not verified.
  • Node 22+ and git
  • dsh 0.1.0-rc.8 on the search path
  • A Spec Kit feature in a git repository
dsh
git clone https://github.com/mairp/specstride-dsh
cd specstride-dsh
# resolves the pinned engine tarballs; nothing compiles
npm install
# renders the skills and the shim, runs every build gate
npm run build
# specstride-host-dsh and the specstride CLI this repository pins
npm install -g . vendor/core/specstride-0.1.0.tgz
# in your repository; the skills go into .dsh/skills/
specstride-host-dsh install --project
# six findings, one line each
specstride-host-dsh doctor

Then, in a dsh session in your repository, say "run the specstride-run skill in dry-run on the feature". It plans and validates and launches nothing. Drop "in dry-run" to run the feature for real.

Commands last run as shown: 2026-11-08

Core (CLI)

Build the engine from a clone and pack its release. Install the specstride CLI on its own, to run it from a shell or to build a host on it. Nothing is on npm yet.

Needs

  • Linux. macOS is not verified.
  • Node 22+ and git
Core (CLI)
git clone https://github.com/mairp/specstride-core
cd specstride-core
npm ci
# packs the four release tarballs into .build/release/
node scripts/pack-release.mjs
npm install -g .build/release/specstride-0.1.0.tgz
# prints the CLI protocol, 1
specstride --protocol
# in your repository
specstride doctor

specstride --help lists every verb. Each verb takes --json, --verbose and -h. To build a host, start from @specstride/host-kit and pass the conformance suite in @specstride/testkit. See the core README.

Commands last run as shown: 2026-11-08

After the first run