pi-vs-claude-code

name	pi-vs-claude-code
description	Pi Coding Agent extension playground. Use when writing, running, or debugging Pi extensions for peer-to-peer communication (coms-net, coms, pi-pi) or multi-agent workflows (agent-team, agent-chain). Bun only — never pnpm/npm.

Pi Coding Agent Extensions

Pi is a coding agent by @mariozechner. This workspace extends it with TypeScript extensions for peer-to-peer communication and multi-agent coordination.

Not Raspberry Pi. Pi = Pi Coding Agent CLI.

Location

lib/pi-vs-claude-code/ — cloned and installed (bun install complete).

Running Extensions

cd lib/pi-vs-claude-code
pi -e extensions/<name>.ts

Key Extensions

Extension	File	Purpose
coms-net	extensions/coms-net.ts (56KB)	HTTP/SSE Pi-to-Pi communication hub
coms	extensions/coms.ts (51KB)	Peer communication layer
pi-pi	extensions/pi-pi.ts (22KB)	Direct Pi-to-Pi messaging
agent-team	extensions/agent-team.ts (22KB)	Multi-agent team coordination
agent-chain	extensions/agent-chain.ts (24KB)	Sequential agent chaining

Environment Variables

Copy lib/pi-vs-claude-code/.env.sample → .env and fill in:

Variable	Purpose
PI_COMS_NET_AUTH_TOKEN	Shared secret for coms-net hub (auto-generates for localhost)
PI_COMS_NET_PORT	Pin server port (optional — leave blank for auto)
PI_COMS_NET_SERVER_URL	Hub URL for clients (optional — auto-discovers via server.json)
ANTHROPIC_API_KEY	Required for Claude-backed extensions
OPENAI_API_KEY	Required for OpenAI-backed extensions

Conventions

• Extensions are standalone .ts files loaded by Pi's jiti runtime
• Available imports: @mariozechner/pi-coding-agent, @mariozechner/pi-tui, @mariozechner/pi-ai, @sinclair/typebox
• Register tools at the top level of the extension function (not inside event handlers)
• Use isToolCallEventType() for type-safe tool_call event narrowing

Package Manager

bun only. Never npm, yarn, or pnpm.

Smoke Test (same-host)

cd lib/pi-vs-claude-code
PI_COMS_NET_AUTH_TOKEN=$(openssl rand -hex 32) pi -e extensions/coms-net.ts