pi-beads

pi extension for beads (bd) task management

Package details

← Back
extension

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

npm repohome report
$ pi install npm:pi-beads
Package
pi-beads
Version
0.2.0
Published
Feb 24, 2026
Downloads
69/mo · 24/wk
Author
emiller88
License
MIT
Types
extension
Size
101.7 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@edmundmiller/pi-beads

pi extension for beads (bd) task management.

Fork of @soleone/pi-tasks stripped down to beads-only, with bd 0.55+ support.

Changes from upstream

  • beads-only: removed todo-md adapter and generic resolver
  • bd 0.55+: added blocked and deferred status support
  • list view: includes blocked tasks alongside open/in-progress

Requirements

  • bd CLI in PATH
  • .beads/ directory in project (run bd init once)

Quick start

{ "extensions": ["~/.config/dotfiles/packages/pi-beads"] }

Toggle with ctrl+x or /tasks.

Keybindings

List view

Key Action
w / s Navigate
space Cycle status (open → in-progress → blocked → deferred → closed)
0–4 Set priority
t Cycle type
e / → Edit task
enter Send task to prompt
tab Insert task ref and close
c Create task
f Search/filter
esc Back / clear filter

Edit view

Key Action
tab Switch focus (title ↔ description)
enter Save
esc Back to nav