A pi coding agent extension that displays the active OpenSpec change status as a persistent TUI widget above the editor, with an interactive dialog for detailed views.

• Persistent TUI widget — always visible above the editor in interactive mode, automatically suppressed in non-interactive modes (-p, --json, headless RPC)
• Single-change detailed view — when one active change exists, shows the change name, schema, OpenSpec workflow-artifact status (proposal, design, specs, tasks), and task progress with apply dependency hints
• Multi-change overview — when multiple active changes exist, shows a header with the active count followed by one condensed line per change with artifact initials, task counters, and blocked-dependency hints
• Artifact status indicators — uses filled circle (●) for done, open circle (○) for ready, and dotted circle (◌) for blocked, each colored with theme-aware success/muted/warning colors
• Interactive dialog — press Ctrl+Alt+O to open a scrollable dialog with full change details, task breakdowns, and dependency info
• Automatic data refresh — fetches from the openspec CLI on session start, after each agent turn/end (debounced 500ms), when tools write to openspec/ or bash commands reference openspec, plus a fallback refresh every 30 seconds
• Error resilience — gracefully shows "CLI not found" when openspec is unavailable, silently no-ops when not in an OpenSpec project, and retains last-known state with a muted error indicator on CLI failures

Widget showing a single active change with artifact status and task progress

Interactive overlay dialog showing detailed change breakdown and dependencies

pi install npm:pi-openspec-status

Or with a specific version:

pi install npm:[email protected]

pi install git:github.com/richards-ensono/pi-openspec-status

Or with a specific version:

pi install git:github.com/richards-ensono/[email protected]

Once installed, the widget appears automatically when you're in a project that has an openspec/changes/ directory with active change subdirectories.

Press Ctrl+Alt+O in interactive mode to open a scrollable dialog displaying the full OpenSpec change status. The dialog shows:

• All active changes with their artifact completion status
• OpenSpec task-progress breakdowns with completed/total counts per change
• Dependency information for blocked artifacts

This is useful when the compact widget above the editor doesn't show enough detail, or when you want to browse through changes in a larger view.

Note: The dialog is only available in interactive mode (it is suppressed in -p, --json, and headless RPC sessions).

• Pi Coding Agent >=0.80.0 <1.0.0 (the package declares compatible Pi and TUI peer dependencies)
• A project using OpenSpec with changes in openspec/changes/
• Each change directory may contain:
  • .openspec.yaml — with a schema field (optional, defaults to "spec-driven")
  • proposal.md, design.md, tasks.md — artifacts tracked as "done" when present
  • specs/ — directory tracked as "done" when non-empty

The widget renders different layouts depending on the number of active changes and available terminal width.

No active OpenSpec changes

◷ add-auth (spec-driven)
Workflow artifacts: proposal ● design ○ specs ○ tasks ○
OpenSpec task progress: ████░░░░░░ 3/7

• Line 1: Status icon (✓ when fully complete, ◷ in-progress, ✗ blocked/error), change name, and schema name in parentheses
• Line 2: Each OpenSpec workflow artifact (proposal, design, specs, tasks) with a status icon — ● done (success), ○ ready (muted), ◌ blocked (warning)
• Line 3: OpenSpec task-progress bar with completed/total count. This is workflow progress, not a claim that code was tested, verified, or security-reviewed.

OpenSpec (2 active)
◷ add-auth  P ● D ○ S ○ T ○  3/7
✗ bugfix    P ● D ◌ S ○ T ○  0/0  (blocked: design)

• Header: "OpenSpec (N active)" in accent color
• Per change (one line): Status icon, truncated change name, artifact initials (P=proposal, D=design, S=specs, T=tasks) each with a status icon, task counter (completed/total), and a blocked-dependency hint when applicable

The overlay recognizes groups introduced by a ## heading and counts only unindented task lines in exactly one of these forms:

- [ ] pending task text
- [x] completed task text

Other checkbox-like content (including indented lines, prose, code blocks, or checkboxes without trailing task text) is ignored. Recognized counts communicate OpenSpec workflow progress only; they are not a comprehensive audit of every task-like line and do not imply testing, verification, or security review.

• Contribution guide
• Security policy
• Maintainer security settings

# Clone and install dependencies
git clone https://github.com/richards-ensono/pi-openspec-status.git
cd pi-openspec-status
npm ci --ignore-scripts
npm run typecheck
npm run lint
npm test

# Test locally with pi
pi -e ./extension/index.ts

MIT