Overview

@oh-my-pi/pi-coding-agent (omp) is a cutting-edge AI coding agent designed for the terminal, extending the powerful capabilities of the original Pi agent with a comprehensive suite of IDE-like features. It seamlessly integrates advanced AI models with your development workflow, offering unparalleled efficiency and intelligence directly within your command-line environment.

Key Features

• IDE-Grade Intelligence: Experience an AI agent that understands your codebase at an IDE level, powered by LSP operations and a real debugger (DAP).
• Optimized Tool Harness: Utilizes a robust and efficient tool system with over 40 providers and 32 built-in tools, including read, edit, ast_edit, bash, eval, and more.
• Hashline Edits: Enables precise, content-anchored code edits that significantly reduce token consumption and eliminate common editing errors.
• Advanced Debugging: Directly drives debuggers (lldb, dlv, debugpy) for C, Go, and Python, allowing for deep inspection and analysis of running code.
• Time-Traveling Stream Rules: Implements a unique mechanism for course-correcting AI responses mid-stream by injecting rules, ensuring higher accuracy without repeated context.
• First-Class Subagents: Facilitates the creation and management of distributed AI agents, enabling parallel task execution with typed results and isolated worktrees.
• Rich Data Interaction: Seamlessly reads and processes diverse data formats, including PDFs from ArXiv, GitHub pages, and Stack Overflow threads, presenting them as structured markdown.
• Native Tooling: Links core functionalities like ripgrep, glob, and find directly into the process, eliminating slow fork-exec round trips and ensuring consistent operation across macOS, Linux, and Windows.
• Git Integration: Empowers atomic commit splitting, dependency-aware ordering, and validated commit messages through deep integration with Git.
• Editor-Driven Agent: Runs as the same agent within editors like Zed, providing a unified experience for terminal and GUI workflows.
• Flexible Model Routing: Connects to over forty providers and hundreds of models, with granular control over routing, fallback chains, and custom provider configurations.
• Comprehensive Search: Offers a powerful web_search tool that chains multiple providers and handles specialized content extraction from code hosts, package registries, research sources, and security databases.

Typical Use Cases

• Automated Code Refactoring & Improvement: Leverage ast_edit and hashline for precise and efficient code modifications, guided by AI.
• Intelligent Code Debugging: Attach to running processes and step through code using integrated debugging tools to pinpoint and resolve issues.
• Code Review & Analysis: Generate detailed code review summaries with prioritized issues and clear verdicts using dedicated reviewer subagents.
• Complex Task Decomposition: Break down large tasks into smaller, manageable units executed by parallel subagents.
• Rapid Prototyping & Exploration: Quickly research topics, summarize documents, and experiment with code snippets directly in the terminal.
• Streamlined Git Workflows: Automate the creation of atomic commits with intelligently generated messages.
• Cross-Platform Development: Utilize a consistent and powerful AI coding environment across macOS, Linux, and Windows.
• Seamless Model Integration: Experiment with and switch between a vast array of AI models for different tasks and roles.