pi: A minimal, extensible agent harness that you can make your own.
What problem it solves
Pi is designed for developers who need to adapt an agent to their own workflows rather than work within a fixed feature set. It provides interactive, automated, RPC, and SDK interfaces while leaving optional capabilities such as sub-agents and plan mode to extensions or packages.
Key features
Extensible agent harness — Customize the harness with extensions, skills, prompt templates, and themes, then bundle these additions as shareable Pi packages.
Source: README
Multiple interaction modes — Use the agent interactively, automate it in print or JSON mode, control it over RPC, or incorporate it into applications through the TypeScript SDK.
Source: README
Unified multi-provider API — The toolkit includes a unified API for working with model providers such as OpenAI, Anthropic, and Google.
Source: README, packages
Interactive coding agent CLI — The coding-agent package provides a terminal-based coding agent that can be launched in a project directory and connected to a supported AI provider.
Source: README
Containerization patterns — For stronger filesystem, process, network, or credential boundaries, Pi documents local micro-VM, Docker, and policy-controlled sandbox patterns.
Source: README
Quick start
Copied verbatim from the project's README.
npm install -g --ignore-scripts @earendil-works/pi-coding-agentcd /path/to/project
piWho it may suit
This may suit developers and teams that want to customize a coding agent workflow, automate agent tasks, or build agent-based applications.
Topics to discuss
Which extensions or Pi packages would be most useful for your workflow?
How should permissions and container boundaries be handled for coding-agent sessions?
Which agent capabilities belong in the core harness rather than an extension?
Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.
Read the original README https://github.com/earendil-works/pi#readme
ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.
Comments
…