Pi

Pi is an open-source terminal coding agent and developer harness developed within a modular monorepo ecosystem. It provides interactive coding assistance directly in the developer terminal through a dedicated text user interface (TUI) and command-line execution workflows. In daily use, Pi operates as an interactive agent that inspects source files, parses repository context, and executes development tasks against configured LLM backends. It integrates repository-level steering mechanisms, relying on structured rules defined in files like AGENTS.md and dedicated configuration directories (.pi) to ensure coding standards, changelog rules, and workflow constraints are respected across tasks. Pi differentiates itself through a modular package architecture, built-in terminal capability overrides, and support for in-place managed updates. Rather than relying on heavyweight GUI abstractions, it keeps all orchestration in the terminal while allowing developers to customize model interaction validation and repository-specific agent behaviors. Pi is distributed as open-source software on GitHub. Users provide their own AI provider credentials and API keys to power the underlying model completions.

Tags: ai agent, cli, coding agent, OpenSource, terminal

Visit Pi

Key features

• Terminal User Interface (TUI) — Provides an interactive terminal interface with support for capability overrides and rich console output. - Repository-Level Agent Rules — Reads project rules and operational constraints from AGENTS.md and dedicated .pi configuration paths. - Modular Monorepo Structure — Architected as decoupled packages separating core AI validation, TUI logic, and coding agent components. - In-Place Agent Updates — Includes automated scripts to manage, verify, and update CLI agent installations directly in place. - Model Integration Validation — Validates generated model schemas and payload data prior to build and execution steps.

Use cases

Use Case: Interactive Terminal Code Refactoring Developers can launch Pi within their terminal workspace to inspect multi-file diffs, review suggested structural improvements, and apply code changes without leaving the command line.

Use Case: Enforcing Project-Specific Agent Rules Teams can configure AGENTS.md and .pi directory rules to constrain Pi's behavior, ensuring generated code adheres to repository style guides, test requirements, and changelog conventions.

Use Case: Automated Script and Package Management Engineers can execute development and maintenance workflows across monorepo packages, leveraging Pi's scripts and CLI components to automate repetitive updates.

Who it is for

Pi is built for software engineers, CLI power users, and maintainers who prefer terminal-native AI development workflows over graphical IDE plugins. It is not intended for non-technical users or developers looking for fully managed web-based chat interfaces.

Install guide

Installation Clone the monorepo and install the project packages using npm or your preferred Node package manager: bash git clone https://github.com/badlogic/pi-mono.git cd pi-mono npm install npm run build

First Run Configure your environment with your model provider credentials and launch the agent CLI: bash export OPENAI_API_KEY="your-api-key-here" # or set other supported model API keys # Run the agent package ./packages/coding-agent/bin/pi

Example Session Pass instructions directly to Pi or open an interactive prompt in your repository root: bash pi "Audit the packages directory and add missing type definitions in the core package"

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

• Gemini CLI — Gemini CLI is an open-source terminal coding agent maintained under the Google Gemini organization (google-gemini/gemini-cli). It provides a command-line and…
• Open Interpreter — Open Interpreter is an open-source terminal coding agent maintained by Killian Lucas and the Open Interpreter community. It is designed…
• Crush — Crush is an open-source terminal coding agent created by Charm (Charmbracelet), the team behind popular Go terminal UI libraries like…
• Hax — Hax is a minimalist, native CLI coding agent created by Oleksandr Chekhovskyi. Written in C and designed for POSIX-compliant environments,…
• San — San is an open-source terminal coding agent developed by the genai-io organization on GitHub. Built natively in Go, San is…
• amux — amux is an open-source agent harness and session multiplexer developed by Mixpeek. Built in Rust, it is designed to manage,…