mirror of https://github.com/badlogic/pi-mono.git synced 2026-11-05 23:37:25 +00:00

History

Armin Ronacher 237a4e80f1 feat(mcp,agent,codemode): expose toLlmContent and document agent-core usage pi-mcp exports toLlmContent(), which converts a CallToolResult to pi-ai-shaped text and image content. The coding agent's MCP adapter uses it. A typechecked example in packages/agent/examples/mcp-codemode shows a plain Agent with MCP tools and a codemode tool whose nested calls go through runToolCall() and the agent's hooks. The pi-mcp, pi-codemode, and pi-agent-core READMEs describe the same wiring.		2026-09-28 00:10:50 +02:00
..
docs	feat(coding-agent): let extensions register MCP servers	2026-09-27 23:50:53 +02:00
examples	feat(codemode,coding-agent): rename the exec tool back to codemode	2026-09-27 23:22:48 +02:00
install-lock	Merge branch 'main' into codemode-and-mcp	2026-09-27 12:26:43 +02:00
scripts	fix: use portable shebang in shell scripts	2026-01-22 21:44:39 +01:00
src	feat(mcp,agent,codemode): expose toLlmContent and document agent-core usage	2026-09-28 00:10:50 +02:00
test	feat(coding-agent): let extensions register MCP servers	2026-09-27 23:50:53 +02:00
.gitignore	Fix tool call ID normalization for cross-provider switches to Anthropic/GitHub Copilot	2026-01-13 04:07:10 +01:00
CHANGELOG.md	feat(coding-agent): remove themes section from startup banner	2026-09-26 14:37:30 +02:00
npm-shrinkwrap.json	Merge branch 'main' into codemode-and-mcp	2026-09-27 12:26:43 +02:00
package.json	refactor(agent,coding-agent): isolate codemode, tool search, and MCP from the core	2026-09-27 21:15:56 +02:00
README.md	docs(coding-agent): refresh documentation (#9898 )	2026-09-22 16:48:19 +02:00
tsconfig.build.json	fix(coding-agent): keep remote harness dependencies development-only	2026-09-05 12:45:04 +02:00
tsconfig.examples.json	chore: migrate pi packages to earendil works scope	2026-05-07 15:59:42 +02:00
vitest.config.ts	fix: use bounded runtime paths for Unix sockets	2026-08-14 17:02:03 +03:00

README.md

New issues and PRs from new contributors are closed automatically. Maintainers review closed submissions daily. See CONTRIBUTING.md.

Pi

Pi is a minimal, extensible AI agent for the terminal. Adapt Pi to your workflow, not the other way around.

Ask Pi to create the prompt templates, skills, extensions, and themes you need, or install a Pi package. Use Pi directly, automate it in print, JSON, or RPC mode, or build applications with the TypeScript SDK.

Getting started

Install the command-line interface with npm:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

This requires Node.js 22.19 or newer. Pi does not require dependency lifecycle scripts for a normal npm installation.

On macOS or Linux, you can instead use the installer:

curl -fsSL https://pi.dev/install.sh | sh

Start Pi in the directory where you want it to work:

cd /path/to/project
pi

For a built-in AI provider, run /login inside Pi to connect a subscription or API key. Then give Pi a task.

See the documentation for full setup and usage instructions.

Development

Clone the repository, install its dependencies, and run Pi from source:

git clone https://github.com/earendil-works/pi
cd pi
npm install --ignore-scripts
./pi-test.sh

pi-test.sh can be called from any directory and preserves the caller's working directory.

Before submitting changes, run:

npm run check
./test.sh

Read CONTRIBUTING.md before opening an issue or pull request. It defines the contribution gate, issue quality bar, and required checks. Read AGENTS.md for repository-specific implementation, testing, dependency, and release rules.

License

MIT