Piverse 🌌

A multi-extension ecosystem for the Pi coding agent.

Extensions

Extension	Command	Description
pi-queue	/queue	Queue messages to run after the current agent turn settles
pi-notes	/notes	Project-level notes with TUI, tags, search, and pinning

Install

pi install npm:@vs4vijay/piverse

Usage

/queue <message>

Queue a message that automatically sends after the current turn finishes.

/queue refactor the auth module next
/queue run the test suite

• /queue (no args) — show pending messages
• /queue-clear — empty the queue

Messages fire one at a time, in order, after each agent_settled event.

/notes

Project-level notes persisted in .pi/notes/notes.json (committed to git, team-shared).

/notes                  # Open the full-screen TUI (list, view, create, edit, delete)
/notes "API contract"   # Quick-add a note with that title (opens editor for content)
/notes list             # List all notes in the CLI
/notes show <id>        # Show a note's full content
/notes edit <id>        # Edit a note's title/content via external editor
/notes search <query>   # Search notes by title/content
/notes tag <id> <tag>   # Add a tag to a note
/notes pin <id>         # Pin a note to the top of the list
/notes rm <id>          # Delete a note (with confirmation)
/notes export [path]    # Export all notes to a JSON file
/notes import <path>    # Import and merge notes from a JSON file

• Persists as JSON, auto-saves on every mutation
• Loads on session_start, flushes on session_shutdown
• TUI keys: ↑/↓ or j/k to navigate, Enter to view, n new, e edit, d delete, p pin, / to filter by typing, q/Esc to quit

Development

git clone git@github.com:vs4vijay/piverse.git ~/GitHub/piverse

Hot-reload (symlink into Pi)

ln -sf ~/GitHub/piverse/extensions/pi-queue ~/.pi/agent/extensions/pi-queue

Edit source → /reload in Pi → changes are live. No build step.

Quick test (no install)

pi -e ./extensions/pi-queue/src/index.ts

Type checking

npm install
npm run typecheck

Project Structure

piverse/
├── extensions/
│   ├── pi-queue/          # /queue - message queueing
│   ├── pi-notes/          # /notes - project notes
│   └── ...                # more extensions coming
├── package.json           # workspace root
├── tsconfig.json          # shared type checking
└── README.md

Contributing

1. Fork & clone
2. mkdir extensions/pi-<name>/src
3. Add package.json with "pi": { "extensions": ["./src/index.ts"] }
4. Implement in src/index.ts
5. Test with pi -e ./extensions/pi-<name>/src/index.ts
6. PR

License

MIT