Set up and track an increment with the SpecWeave CLI

You see how specweave init, create-increment and status set up and track a piece of work.

SpecWeave01:07Recorded 3 May 2026

You need: Node.js 20.12 or later and git

Steps

  1. Install SpecWeave with npm i -g specweave, then run specweave init in your repository.
  2. Plan a feature with specweave create-increment "title". It creates the increment's spec.md, where you write the problem, acceptance criteria and tasks.
  3. Run specweave pickup to see the open increment and the next task with its acceptance criteria.
  4. Claim the task with specweave task claim T-01. When it is done, run specweave task done T-01 --run "<test>" so the test output is saved as evidence.
  5. Check the increment with specweave verify, then close it with specweave complete <id>. Run specweave status at any point to see progress.
Transcript

SpecWeave is a CLI-first framework. Six commands you'll reach for every day — let's run them in order.

Start a new project with specweave init. One command scaffolds the whole .specweave folder, plugins, and documentation pipeline — ready in seconds.

Plan a feature with specweave create-increment. SpecWeave generates spec, plan, tasks and metadata — every artifact wired to the same increment number.

Track progress with specweave status. Active increments, task completion, pending sync to GitHub or Jira — all on one screen, no browser tab required.

Generate docs with specweave living-docs. Specs become a Docusaurus site automatically — your specs ARE the documentation, always in sync with the code.

Six commands — init, create-increment, status, living-docs, save, complete. Full reference at verified-skill dot com slash docs slash cli-reference. That's the SpecWeave CLI.

The narration as voiced in the video.

Learning path

Plan the work that uses them

Skills do the work; SpecWeave plans it and records it in git, and SpecWithCode runs it across agents.

  1. Set up and track an increment with the SpecWeave CLI

    You are here
  2. Plan, prove and hand off a task with the CLI

    SpecWeave guide on spec-weave.com
  3. See how SpecWithCode runs your agents

    SpecWithCode guide on spec-weave.com

Plan the work that uses your skills: SpecWeave tutorials on spec-weave.com.

SpecWeave CLI: init, create-increment and status | Verified Skill