pi-cavekit

Cavekit spec-driven development skills and spec tracker widget for pi

Package details

← Back
extensionskill

Install pi-cavekit from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-cavekit
Package
pi-cavekit
Version
1.0.0
Published
Apr 25, 2026
Downloads
141/mo · 141/wk
Author
dnevb
License
MIT
Types
extension, skill
Size
26.8 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "extensions/spec-tracker.ts"
  ],
  "skills": [
    "skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-cavekit

Cavekit spec-driven development skills for pi, plus a live TUI spec tracker widget.

Install

pi install git:github.com/dnevb/pi-cavekit

Skills

Skill Description Invoke
spec Create, amend, backprop SPEC.md /skill:spec
build Plan-then-execute against spec /skill:build
check Read-only drift detector /skill:check
caveman Token-compressed spec encoding /skill:caveman
backprop Bug → invariant protocol /skill:backprop

Spec Tracker Widget

A persistent TUI widget that auto-detects SPEC.md changes and shows progress:

Spec: x~.. (1/4) V2 B1  impl auth middleware

Updates automatically when SPEC.md is:

  • Read (via the read tool)
  • Written (via the write tool)
  • Edited (via the edit tool)
  • Session start (reconstructs from branch or scans filesystem)

Format

See FORMAT.md for the SPEC.md schema and caveman encoding rules.

Development

npm test
npm run test:watch

Tests cover:

  • Spec tracker parsing, formatting, state reconstruction
  • Skill validation (frontmatter, cross-references, file refs)