Reqall Pi Plugin

Persistent semantic memory for the Pi coding agent harness.

This is patterned after @reqall/claude-plugin, but uses Pi-native extension APIs instead of Claude hooks/MCP configuration:

• registers reqall_* tools that call the Reqall MCP HTTP endpoint directly
• injects project context on before_agent_start
• adds Reqall memory instructions to the system prompt
• bundles Pi-compatible Agent Skills
• adds slash commands for common Reqall workflows
• shows Reqall status in Pi's footer

Installation

From this repository while developing:

pi install ./pi-plugin
# or for one run only:
pi -e ./pi-plugin

When published:

pi install npm:@reqall/pi-plugin

Set your API key before launching Pi:

export REQALL_API_KEY="rq_..."
# Optional:
export REQALL_URL="https://www.reqall.net"
export REQALL_PROJECT_NAME="org/repo"

What It Adds

Tools

Pi does not currently include built-in MCP client configuration, so the extension registers Pi tools that wrap Reqall's MCP tools:

• reqall_project_context — Pi-specific one-call context hydration
• reqall_search
• reqall_upsert_project
• reqall_upsert_record
• reqall_get_record
• reqall_list_records
• reqall_list_projects
• reqall_upsert_link
• reqall_list_links
• reqall_impact
• reqall_delete_record (explicit user request only)
• reqall_delete_link (explicit user request only)
• reqall_sleep_candidates
• reqall_sleep_apply

Automation

| Pi event | Behavior | |---|---| | session_start | Shows Reqall status in the footer | | before_agent_start | Detects project, injects system prompt guidance, and (by default) fetches context via Reqall | | agent_end | Reminds about persistence for non-trivial turns; can optionally queue a follow-up persistence turn |

Commands

• /reqall-context [query] — fetch context and trigger a model turn with it
• /reqall-persist [summary] — ask the agent to classify and persist completed work
• /reqall-review [filter] — review open records
• /reqall-triage [description] — triage a new issue/request
• /reqall-sleep [project-id-or-name] — run SLEEP maintenance

Skills

Skills are bundled under Pi-compatible names:

• /skill:reqall-context
• /skill:reqall-persist
• /skill:reqall-document
• /skill:reqall-triage
• /skill:reqall-review
• /skill:reqall-sleep

Environment Variables

| Variable | Default | Description | |---|---:|---| | REQALL_API_KEY | required | Reqall API key (rq_...) | | REQALL_URL | https://www.reqall.net | Reqall server base URL | | REQALL_API_URL | unset | Fallback base URL if REQALL_URL is not set | | REQALL_PROJECT_NAME | auto | Override project name | | REQALL_CONTEXT_LIMIT | 5 | Semantic search result count for context injection | | REQALL_OPEN_LIMIT | 25 | Open-record count for context injection | | REQALL_AUTO_CONTEXT | inject | inject, reminder, or off | | REQALL_AUTO_PERSIST | reminder | reminder, followup, or off |

Pi-Specific Extension Ideas

Pi can go beyond the Claude plugin because extensions can register tools, commands, UI, status lines, autocomplete, session labels, and lifecycle handlers. Good follow-ups to discuss/implement:

1. Interactive TUI review panel for open records.
2. #123 Reqall record autocomplete in the editor.
3. Session labels/bookmarks for persisted Reqall record IDs.
4. Optional true MCP client transport if Pi adds first-class MCP support or we vendor a client.
5. Compaction hook that preserves Reqall decisions/follow-ups in Pi's session summaries.
6. Safer auto-persist mode that uses a structured final-output tool instead of a follow-up prompt.

Development

cd pi-plugin
npm install
npm test

npm test typechecks the extension, verifies the CLI manifest output, and runs npm pack --dry-run.

To verify the deployed Reqall MCP base surface from https://www.reqall.net/docs/mcp.md, set REQALL_API_KEY and run:

npm run verify:mcp

This live smoke test checks HEAD /mcp, confirms the documented tool list, creates two temporary records, searches/lists/reads them, links them, traverses impact, then deletes the temporary link and records.

License

MIT