Pi Agent
Run the Pi coding agent in a session, including quick start and session management.
Spin up the Pi coding agent inside a VM, open a session, and send it prompts. Reach for this when you want an end-to-end agent loop — quick start plus the session knobs for skills and MCP servers.
How it works
The server registers a VM with the pi software package and starts the registry. The client grabs a VM with getOrCreate, then createSession("pi", …) passing the ANTHROPIC_API_KEY through env. From there sendPrompt runs a turn and returns the agent’s text. Sessions are configurable: drop a SKILL.md into the agent’s skills directory (via mkdir + writeFile) before creating the session and it’s auto-discovered, and pass mcpServers (local child-process or remote URL) to expose extra tools. Pre-install any npx-launched MCP server so install output doesn’t corrupt the stdio handshake.
Run it
npm install
ANTHROPIC_API_KEY=sk-... npx tsx server.ts # then run the client in another shell
The agent answers the prompt and prints its response to the console.