Skip to content

Specnaut

Turns your AI coding assistant into a disciplined team, inside your own repo

Specnaut is a native CLI that scaffolds, inside your project, the skills, agents and guardrails your AI coding assistant reads. You describe the work; the assistant plans it, asks you only the questions that are yours to answer, builds it, has specialist agents review it, merges it and closes the backlog item. Specnaut itself never calls a model: your assistant does the thinking, Specnaut gives it the method.

Specnaut is for solo developers and small teams who already code with an AI assistant and want one method across their projects. It works with six harnesses, with first-class support for Claude Code and Codex. It is a single native binary under the MIT license, an enhanced fork of GitHub's Spec Kit; download the latest release.

Features

Autopilot workflow

From backlog item to merged branch, with one stop at most.

The /task chain

One chain takes a change from plan to implementation, review, merge and push. It stops at most once, and only for questions about your product.

Experts decide, nobody votes

Architecture, security and performance choices are settled by specialist agents and reported to you, not put to a vote.

Manual merge

Switch to manual merge and the chain stops once before merging to ask for your approval.

/task resume

Pick an interrupted chain back up where it stopped.

Features

Review and quality

Review seats

A code reviewer and a security expert look at every change. Accessibility, dependency and performance experts join when the change calls for them.

Quality gates

Your gates run in an implement, review and fix loop. Only CRITICAL and HIGH findings block the merge.

/task audit

Run a read-only audit of your codebase on the axes you choose: architecture, security, performance, accessibility or dependencies.

specnaut verify-scripts

Check the project's Specnaut scripts against a trusted copy before a review or a merge runs them.

specnaut scan

Map file, function and class sizes against your size limits, offline, to see where to look first.

Features

Backlog

Product Owner agent

A dedicated agent writes and grooms your backlog items, and every backlog write goes through it.

Your choice of backend

Keep the backlog in Specnaut Cloud (the default), in local Markdown files, in GitHub Issues and Projects, or in GitLab.

Groom, next and status

Groom the backlog, ask which item to take next, and see where the work stands.

Secret guard

Every backlog write is scanned, and text that looks like a secret is refused before it reaches an issue.

Features

Shipping

/ship

Tag and publish a release as a deliberate step of its own, separate from merging.

Features

The framework

/specnaut commands

Ask how Specnaut works, list the skills and agents installed in your project, upgrade it, or report an issue to its public tracker.

Safe upgrades

Preview an upgrade before applying it, and use specnaut diff to see how your files differ from the bundled originals.

Phase addenda

Add your project's own steps to a phase without editing the files Specnaut manages.

Project constitution

Write your project's binding rules once. Every plan, change and review is checked against them.

Features

Harnesses and install

Six harnesses

Works with Claude Code (the default), Codex, Cursor, Copilot CLI, OpenCode and Antigravity, with first-class support for Claude Code and Codex.

Native binary

Install one native binary with a curl script, with Homebrew or by direct download.

Specnaut Cockpit

A status band in Claude Code shows your usage limits, context, cost and chain progress, and pauses the autopilot before you reach a limit.