oh-my-pi

oh-my-pi: The Ultimate AI Agent Toolkit for Your Terminal

oh-my-pi is a comprehensive, monorepo-based AI agent toolkit designed to supercharge your terminal workflow. Built with a focus on performance, flexibility, and developer experience, it integrates a powerful AI coding agent, a unified LLM API client, and robust TUI (Terminal User Interface) and web UI libraries. This toolkit empowers developers to leverage AI for a wide range of tasks, from intelligent code generation and commit assistance to complex task management and interactive code reviews, all within the familiar environment of their terminal.

Core Features and Philosophy

At its heart, oh-my-pi aims to bring the power of AI directly into the developer's workflow, making AI-assisted coding seamless and efficient. The toolkit is built around several key principles:

• Performance First: Utilizing Rust for native N-API addons, oh-my-pi delivers high-performance operations without relying on slow external shell commands. This ensures a snappy and responsive user experience, even for computationally intensive tasks.
• Modularity and Extensibility: The monorepo structure, with packages like @oh-my-pi/pi-ai, @oh-my-pi/pi-agent-core, @oh-my-pi/pi-coding-agent, @oh-my-pi/pi-tui, and @oh-my-pi/pi-natives, allows for independent development and easy integration of new features and tools.
• Unified Interface: A single toolkit provides access to multiple AI models and providers (Anthropic, OpenAI, Gemini, Bedrock, Cursor, Codex, Copilot, Exa) through a unified API, simplifying LLM interactions.
• Developer Experience: From intelligent commit generation and task tracking to interactive code reviews and a customizable TUI, oh-my-pi prioritizes making complex AI tasks accessible and manageable.
• Time Traveling Streamed Rules (TTSR): A novel approach to AI interaction where rules are injected only when relevant, triggered by patterns in the AI's output stream. This optimizes context usage and prevents unnecessary computations.
• Universal Configuration Discovery: The toolkit automatically discovers and loads configurations from various AI coding tools (Claude Code, Cursor, Windsurf, Gemini, Codex, Cline, GitHub Copilot, VS Code), providing a unified and powerful experience.

Key Components and Tools

oh-my-pi is comprised of several powerful tools, each designed to address specific aspects of the AI-assisted development workflow:

1. AI Coding Agent (@oh-my-pi/pi-coding-agent)

This is the flagship component, offering a rich set of AI-powered features directly in your terminal:

• AI Commit Tool: Generates conventional commits using AI, analyzing code changes with tools like git-overview, git-file-diff, and git-hunk. It supports split commits, hunk-level staging, changelog generation, and commit validation to enforce best practices.
• Python Tool (IPython Kernel): Provides an interactive Python environment with a persistent IPython kernel and over 30 shell-like helpers. It supports streaming output for stdout/stderr, image rendering, JSON display, and integrates Git utilities like git_status() and git_diff(). It also includes line manipulation tools and supports custom modules loaded from project directories.
• LSP Integration: Offers IDE-like code intelligence by integrating with Language Server Protocol servers. This includes automatic formatting on write, diagnostics for errors and type issues, support for numerous languages, and local binary resolution for project-specific LSP setups.
• Time Traveling Streamed Rules (TTSR): A unique feature that allows rules to be injected only when triggered by specific patterns in the AI's output stream. This is particularly useful for enforcing constraints or providing context-sensitive guidance without consuming tokens unnecessarily.
• Interactive Code Review: Facilitates structured code reviews with priority-based findings (P0-P3). Agents can compare branches, analyze uncommitted changes, or review specific commits, providing actionable feedback.
• Task Tool (Subagent System): Enables parallel execution of tasks with specialized agents (explore, plan, browser, task, reviewer). It supports real-time artifact streaming, isolated execution in worktrees, and concurrency-limited batch processing.
• Ask Tool: Provides structured user interaction through typed options, multi-select capabilities, and multi-part questions, allowing for more controlled and precise AI guidance.
• Custom TypeScript Slash Commands: Allows users to create their own commands using TypeScript, leveraging the full API context for UI dialogs, session control, and shell execution.
• Universal Config Discovery: Automatically detects and loads configurations from various AI tools, including Cursor, Windsurf, Gemini, Codex, Cline, and GitHub Copilot, creating a unified AI environment.
• Multi-Credential Support: Manages multiple API keys for different providers (OpenAI, Anthropic, Gemini, etc.) with round-robin distribution, usage-aware selection, and automatic fallback mechanisms.
• Image Generation: Integrates with Gemini and OpenRouter to generate images directly from the terminal, with inline display in compatible terminals.
• TUI Overhaul: Features a modern terminal interface with auto-session titles, a welcome screen, a Powerline-style footer displaying system and Git status, LSP status indicators, and extensive hotkey support.
• Edit Fuzzy Matching: Automatically handles whitespace and indentation differences in edits, preventing common errors.
• Native Engine (Rust N-API): Core operations like grep, shell, text manipulation, keys parsing, highlighting, glob matching, and task scheduling are implemented in Rust for maximum performance.

Target Audience

oh-my-pi is designed for developers who spend a significant amount of time in the terminal and want to integrate AI assistance directly into their existing workflows. It's particularly beneficial for:

• Developers seeking efficiency: Automate repetitive tasks, generate boilerplate code, and get instant feedback on code quality.
• AI enthusiasts: Explore the latest AI models and techniques within a powerful, integrated terminal environment.
• Power users: Customize their AI tools and workflows with custom agents, commands, and configurations.
• Teams: Standardize AI-assisted development practices across projects using shared configurations and agents.

Unique Selling Points

• Terminal-native AI: Brings advanced AI capabilities to the command line, a space often underserved by AI tools.
• Comprehensive Feature Set: Covers a wide range of AI-assisted development tasks, from coding and review to project management and system interaction.
• Performance and Reliability: Built with Rust for speed and stability, ensuring a smooth user experience.
• Extensibility: The plugin system and custom agent support allow for deep customization and integration with other tools.
• Innovative TTSR: A novel approach to AI rule management that optimizes resource usage and enhances control.

oh-my-pi represents a significant step forward in making AI a truly integrated and indispensable part of the developer's daily toolkit, enhancing productivity and creativity directly within the terminal.