pi-coding-agent

@mariozechner/pi-coding-agent (upstream) ships both the pi interactive TUI and a first-class SDK. With the SDK you can spawn an agent session from any Node 20.6+ script, stream its output, scope its tools, and bolt on your own tools — without forking the CLI.

When to use

• Building a single-purpose agent CLI in TypeScript / Node (not a chat product)
• Wrapping pi inside a larger Node service or job runner
• Embedding agent reasoning into a script pipeline (one-shot, exit on done)
• You need read-only or domain-restricted tool sets
• You want to add custom tools (deploy, query_db, …) the agent can call

Skip this skill if:

• You just want to use pi interactively → run pi from the CLI, no SDK needed
• Your host is not Node — use pi --mode rpc (JSON-RPC over subprocess) instead
• You want Anthropic's official SDK semantics → that is @anthropic-ai/claude-agent-sdk, a different package

Pitfalls (read first)