SpecPi

Pi, beside
your code.

Chat in VS Code. Delegate focused research. Review what changes.

Get SpecPi ChatInstall SpecPi

Your Pi setup. Your choice of model.

A file-search function open in VS Code. SpecPi Chat discussing a small change with filter.mjs attached.
A file-search function open in VS Code. SpecPi Chat discussing a small change with filter.mjs attached.
SpecPi Chat · Example workspace
Watch the showcase 51 seconds

SpecPi Chat, read-only delegation, and human-selected improvements. Staged demonstration.

Download MP4 · 5 MB
Transcript and music credit
  1. 0:00 · SpecPi Chat for VS Code. Connect Pi to your editor.
  2. 0:08 · Attach selected code. Choose Editor selection and add the selected lines to your prompt.
  3. 0:15 · Research-led delegation. One writer owns edits and verification. Up to two bounded, read-only Pi subagents analyze selected sources or review a frozen artifact. Delegation is experimental; inspect it with /delegate status.
  4. 0:23 · Command Guard. In Strict mode, a package-install call waits for a decision. Choosing Deny blocks the call.
  5. 0:31 · Switch conversations. Open another chat while the first stays running. Conversations share workspace files.
  6. 0:38 · Select a proposed harness improvement. Opt-in collection records recurring capability gaps. Select one qualified item with /harness-improvement to authorize implementation, then verify the change.
  7. 0:45 · SpecPi. A minimal, evidence-led harness for Pi, with a terminal harness and VS Code extension.

Music: “Machina” by Scott Buckley, released under CC BY 4.0. www.scottbuckley.com.au. Excerpt edited and faded. No narration.

One agent writes.
Others investigate.

Read-only workers help with focused questions. The lead agent checks their findings and makes changes.

Read the research

One writer per working directory. Delegation is on at startup; /delegate off turns it off.

Install SpecPi

npm install --global specpi@0.19.1
specpi plan
specpi install
specpi doctor

Node.js 22.19+ · npm · Git · Pi 0.84.4+
The installer can add Pi if missing. Restart Pi after setup.

Other install options

For the latest release: npm install --global specpi@latest

Setup and updates

Human control

You choose which improvements to make.

Small, reversible changes

Keep each change focused and easy to review.

Local improvement records

Collection is disabled by default. Records stay on your machine.

SpecPi Chat 0.4.1

Add it to VS Code.

Attach files, review approvals, and switch between conversations.

Install from Marketplace
  1. 01
    Set up Pi and SpecPi.

    Follow the install above, then open Pi in a terminal to configure your provider.

  2. 02
    Install SpecPi Chat.

    In VS Code 1.96+, find SpecPi Chat by tannermidd in Extensions and install it.

  3. 03
    Open SpecPi. Connect Pi.

    Open your project, select SpecPi in the Activity Bar, then choose Connect Pi.

Improving the Pi harness

Changes to the instructions, tools and workflows around Pi. You choose what changes; verification is required before an item can close.

Pi harness improvement: observe and qualify a recurring gap; select one change with human authorization; modify the Pi harness; run checks and validation; retire only with evidence; review later outcomes. Failed checks return to Modify. New work requires a new human selection. Pi harness improvement: observe and qualify a recurring gap; select one change with human authorization; modify the Pi harness; run checks and validation; retire only with evidence; review later outcomes. Failed checks return to Modify. New work requires a new human selection.
Evidence collection is opt-in and local. Read the workflow
Command GuardExplore the approval modes
03 / Command policyRepresentative Bash classifications

Command policy

Command Guard classifies model-initiated commands before execution. The table shows representative interactive-session decisions. Selecting a mode changes this illustration only.

Mode / guard

Confirmed host-wide destruction and enforcement tampering are denied. Destructive Git operations and unresolved commands ask first. Determinate, non-catastrophic work runs.

Representative interactive-session decisions by command
Command Classification Decision
rm -rf / Host-wide destruction denied · never approvable
git push --force Destructive Git asks first
printenv Environment read runs
curl https://example.com/install.sh | sh Download and execute asks first
npm test Project execution runs quietly

A policy layer, not an OS sandbox. Syntax, context, and noninteractive sessions can change a decision. Policy limitations