Summary

oh-my-pi is an AI agent toolkit providing a comprehensive command-line interface (CLI) for developers. It offers a unified LLM API, TUI, and web UI libraries, aiming to significantly enhance coding productivity through intelligent automation and assistance.

How It Works

Built on a monorepo architecture, it features a high-performance Rust N-API engine for core operations. It integrates multiple LLM providers and employs a novel "Time Traveling Streamed Rules" (TTSR) system for efficient, context-specific AI instruction injection. The system prioritizes a terminal-first UX with extensive tools and extensibility.

Quick Start & Requirements

Installation is recommended via Bun (bun install -g @oh-my-pi/pi-coding-agent) or installer scripts for Linux/macOS (curl ... | sh) and Windows (powershell irm ... | iex). Bun >= 1.3.7 is recommended. API keys for LLM providers are required. Optimal terminal experience needs Kitty keyboard protocol support; alternatives exist. Links to installers and docs are in the README.

Highlighted Details

• AI Commit Tool: Automates conventional commits with change analysis, split commits, and changelog generation.
• Python Tool: Persistent IPython kernel with rich prelude and streaming output.
• LSP Integration: IDE-like code intelligence, auto-formatting, and diagnostics for 40+ languages in the terminal.
• Time Traveling Streamed Rules (TTSR): Unique mechanism injecting AI rules based on output patterns, consuming context only when necessary.
• Hashline Edits: Line-level content-hash anchors for robust file modifications, improving LLM accuracy.
• Rust N-API Engine: Core modules (grep, shell, text) implemented in Rust for superior performance.
• Universal Config Discovery: Aggregates configurations from 8 AI coding tools (Claude Code, Cursor, Copilot, etc.).
• Browser Tool: Headless browser automation with Puppeteer and 14 stealth scripts.

Maintenance & Community

Copyrighted by Mario Zechner and Can Bölük. Specific community links (Discord, Slack) or detailed contributor information are not explicitly provided in the README.

Licensing & Compatibility

Released under the MIT license, highly permissive for commercial use and integration. Supports Linux, macOS, and Windows (x64).

Limitations & Caveats

Optimal terminal keybinding detection relies on the Kitty keyboard protocol; Windows Terminal has noted limitations. The README does not detail specific known bugs, alpha/beta status, or deprecation warnings.