@howaboua/pi-todomaster

TodoMaster extension for Pi

Package details

← Back
extension

Install @howaboua/pi-todomaster from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@howaboua/pi-todomaster
Package
@howaboua/pi-todomaster
Version
0.1.0
Published
Mar 22, 2026
Downloads
16/mo · 2/wk
Author
howaboua
License
MIT
Types
extension
Size
349.7 KB
Dependencies
2 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-todomaster

pi-todomaster adds a checklist-first planning system to Pi.

It provides an interactive /todo UI for managing three document types:

  • PRDs
  • specs
  • todos

What you can do

  • create PRD/spec/todo plan files under .pi/plans
  • open focused list views for tasks, PRDs, specs, and closed items
  • run work/refine/review flows from the action menu
  • attach and validate bidirectional links between related plan files
  • edit todo checklists directly from the UI
  • claim/release assignment per session
  • use a standardized SDK-based TUI shell shared across extensions
  • mark items as ralph-loop or ralph-loop-linked and stage a canonical loop command from the action menu

Checklist and status model

For todo items, checklists are the primary progress signal:

  • todos MUST include a non-empty checklist on create
  • checking items updates progress deterministically
  • status is derived from checklist completion for checklist-based work

Keyboard workflow highlights

  • list views:
    • j/k or arrows to move
    • Enter to open actions
    • / to search
    • Ctrl+X to open More options (auto-timeout)
    • Tab / Shift+Tab cycle list panes
  • detail/actions:
    • j/k move through actions
    • v toggles attached detail preview
    • preview uses J/K for scrolling
    • Esc returns back
  • create/edit inputs:
    • Enter submits
    • Shift+Enter, Ctrl+Enter, or Alt+Enter inserts new lines

Storage

Plan files are stored in:

  • .pi/plans/prds
  • .pi/plans/specs
  • .pi/plans/todos

Each item is markdown with frontmatter and uses type (prd, spec, todo) for classification.

Install

pi install npm:@howaboua/pi-todomaster

Local package development:

npm install
npm run build

Publish on npm

This package is configured for public npm publishing and Pi registry discovery:

  • keywords include pi-package and pi-extension
  • publishConfig.access is set to public
  • the published tarball includes the source extension entrypoint plus the built Node CLI helper under dist/

Useful commands:

npm run publish:dry-run
npm run publish:dev
npm run release:dev

Typical release flow:

npm login
npm run publish:dry-run
npm publish