agent-bridge-pi

agent-bridge-pi is the official Pi Host package for AgentBridge, a compatibility-first bridge between local coding-agent CLIs.

Pi is a Host only. The package lets Pi delegate to these existing Targets:

• Claude Code
• Codex
• Grok Build
• Antigravity

It ships 16 Agent Skills: plan, review, rescue, and result-handling for each Target.

Installation

Install the npm package named agent-bridge-pi as a user-level Pi Package. Project-local installation with pi install -l is not supported in V1. See the Pi installation guide for the current release status and verified command.

On first Skill use, the package installs the shared engine and Pi-locked wrapper under:

~/.agent-bridge/engine/
~/.agent-bridge/bin/agent-bridge-pi

The package discovery root honors:

${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}

Compatibility and Safety

• CLI-only integration; no MCP interface and no Pi Extension registration.
• The wrapper locks AGENT_BRIDGE_LOCKED_HOST=pi; Pi session metadata is not trusted as authorization.
• Pi is not added as a Target, and the package contains no Pi Target adapter.
• plan, review, and default rescue remain read-only.
• Write-enabled rescue requires explicit user intent.
• No bare/minimal session flags, yolo mode, or dangerous approval bypasses.
• Nested AgentBridge delegation is rejected.
• AgentBridge never commits or pushes automatically.

AgentBridge uses one shared Core and version across its Claude Code, Codex, Grok Build, and Pi distribution surfaces. Changes are validated against the full Host/Target compatibility matrix rather than Pi alone.

Documentation

• Pi installation and updates
• AgentBridge design
• Compatibility differences

License

MIT