pi-ai-bridge

A Pi extension that lets the Pi agent — and you — delegate work to other AI CLIs (claude, codex, gemini) as background, full-autonomy agents. The Pi model can call them on its own when useful, or you can trigger them with slash commands.

⚠️ Safety warning

Calls run with full autonomy (yolo) and in the background, and the external agent can read and edit files / run commands in the working directory:

• claude -p … --dangerously-skip-permissions
• codex exec … --dangerously-bypass-approvals-and-sandbox -C <cwd>
• gemini -p … --yolo

Use it only in repositories you trust. The working directory is always explicit (defaults to the session cwd), so the blast radius is that directory.

Install

pi install npm:pi-ai-bridge

This adds "npm:pi-ai-bridge" to ~/.pi/agent/settings.json packages. Restart Pi to load it.

Tools (the model calls these)

| Tool | Purpose | |---|---| | ask_ai({ provider, prompt, wait?, timeoutMs?, cwd?, model? }) | Start an agent. Background by default (returns a jobId); pass wait: true to block and return the output inline. | | check_ai({ jobId, tailLines? }) | Status + output tail of a job. | | list_ai() | Recent / running jobs. | | cancel_ai({ jobId }) | Kill a running job. |

Slash commands (you trigger these)

/ask <claude|codex|gemini> <prompt>        start a background agent
/ask-wait <claude|codex|gemini> <prompt>   run and show the output here (blocks)
/ai-jobs                                   list jobs
/ai-result [id] [lines]                    show status + output (no id = latest job)
/ai-cancel <id>                            cancel a job
/ai-help                                   list commands and providers

Providers

| Provider | Binary | Invocation | |---|---|---| | claude | claude | claude -p <prompt> --dangerously-skip-permissions [--model <m>] | | codex | codex | codex exec <prompt> --dangerously-bypass-approvals-and-sandbox -C <cwd> [-m <m>] | | gemini | gemini | gemini -p <prompt> --yolo [-m <m>] |

The matching CLI must be installed and on your PATH.

Display

• Tool results are color-coded by status (green = done, red = failed, yellow = running, dim = canceled), with a bold header, via the runtime theme.
• A "agents running" widget appears below the input while background agents are active, showing provider, job id and elapsed time — similar to background tasks in Claude Code.

Job state

Background jobs are tracked in ~/.pi/agent/ai-bridge/jobs/ as <id>.json (metadata) and <id>.log (combined stdout+stderr). Because jobs are spawned detached with state on disk, they survive a Pi restart.

Local development

npm install
npm run check   # type-check
npm test        # unit tests (providers + jobs)
pi -e ./src/index.ts   # load the extension from this checkout

License

MIT