oh-my-pi

Highlights

+ Commit Tool (AI-Powered Git Commits)

AI-powered conventional commit generation with intelligent change analysis:

• Agentic mode: Tool-based git inspection with git-overview, git-file-diff, git-hunk for fine-grained analysis
• Split commits: Automatically separates unrelated changes into atomic commits with dependency ordering
• Hunk-level staging: Stage individual hunks when changes span multiple concerns
• Changelog generation: Proposes and applies changelog entries to CHANGELOG.md files
• Commit validation: Detects filler words, meta phrases, and enforces conventional commit format
• Legacy mode: --legacy flag for deterministic pipeline when preferred
• Run via omp commit with options: --push, --dry-run, --no-changelog, --context

+ Python Tool (IPython Kernel)

Execute Python code with a persistent IPython kernel and rich helper prelude:

• Streaming output: Real-time stdout/stderr with image and JSON rendering
• Prelude helpers: File I/O, search, find/replace, line operations, shell, and text utilities built into the kernel
• Line operations: lines(), insert_at(), delete_lines(), delete_matching() and related helpers for precise edits
• Shared gateway: Resource-efficient kernel reuse across sessions (python.sharedGateway setting)
• Custom modules: Load extensions from .omp/modules/ and ~/.omp/agent/modules/
• Rich output: Supports display() for HTML, Markdown, images, and interactive JSON trees
• Markdown rendering: Python cell output with Markdown content renders inline
• Mermaid diagrams: Renders mermaid code blocks as inline graphics in iTerm2/Kitty terminals
• Install dependencies via omp setup python

+ LSP Integration (Language Server Protocol)

Full IDE-like code intelligence with automatic formatting and diagnostics:

• 11 LSP operations: diagnostics, definition, type_definition, implementation, references, hover, symbols, rename, code_actions, status, reload
• Format-on-write: Auto-format code using the language server's formatter (rustfmt, gofmt, prettier, etc.)
• Diagnostics on write/edit: Immediate feedback on syntax errors and type issues after every file change
• Workspace diagnostics: Check entire project for errors with lsp action diagnostics (without a file)
• 40+ language configs: Out-of-the-box support for Rust, Go, Python, TypeScript, Java, Kotlin, Scala, Haskell, OCaml, Elixir, Ruby, PHP, C#, Lua, Nix, and many more
• Local binary resolution: Auto-discovers project-local LSP servers in node_modules/.bin/, .venv/bin/, etc.
• Symbol disambiguation: occurrence parameter resolves repeated symbols on the same line

+ Time Traveling Streamed Rules (TTSR)

Zero context-use rules that inject themselves only when needed:

• Pattern-triggered injection: Rules define regex triggers that watch the model's output stream
• Just-in-time activation: When a pattern matches, the stream aborts, the rule injects as a system reminder, and the request retries
• Zero upfront cost: TTSR rules consume no context until they're actually relevant
• One-shot per session: Each rule only triggers once, preventing loops
• Define via ttsrTrigger field in rule files (regex pattern)

Example: A "don't use deprecated API" rule only activates when the model starts writing deprecated code, saving context for sessions that never touch that API.

+ Interactive Code Review

Structured code review with priority-based findings:

• /review command: Interactive mode selection (branch comparison, uncommitted changes, commit review)
• Structured findings: report_finding tool with priority levels (P0-P3: critical → nit)
• Verdict rendering: aggregates findings into approve/request-changes/comment
• Combined result tree showing verdict and all findings

+ Task Tool (Subagent System)

Parallel execution framework with specialized agents and real-time streaming:

• 6 bundled agents: explore, plan, designer, reviewer, task, quick_task
• Parallel exploration: Reviewer agent can spawn explore agents for large codebase analysis
• Real-time artifact streaming: Task outputs stream as they're created, not just at completion
• Full output access: Read complete subagent output via agent://<id> resources when previews truncate
• Isolation backends: isolated: true runs tasks in git worktrees, Unix fuse-overlay filesystems, or Windows ProjFS (fuse-projfs), with patch or branch merge strategies
• Async background jobs: Background execution with configurable concurrency (up to 100 jobs) and await tool for blocking on results
• Agent Control Center: /agents dashboard for managing and creating custom agents
• AI-powered agent creation: Generate custom agent definitions with the architect model
• Per-agent model overrides: Assign specific models to individual agents via swarm extension
• User-level (~/.omp/agent/agents/) and project-level (.omp/agents/) custom agents

+ Model Roles

Configure different models for different purposes with automatic discovery:

• Role-based routing: default, smol, slow, plan, and commit roles
• Configurable discovery: Role defaults are auto-resolved and can be overridden per role
• Role-based selection: Task tool agents can use model: pi/smol for cost-effective exploration
• CLI args (--smol, --slow, --plan) and env vars (PI_SMOL_MODEL, PI_SLOW_MODEL, PI_PLAN_MODEL)
• Configure roles interactively via /model selector and persist assignments to settings

+ Todo Tool (Task Tracking)

Structured task management with phased progress tracking:

• Phased task lists: Organize work into named phases with ordered tasks
• 5 operations: replace (setup), add_phase, add_task, update (status changes), remove_task
• 4 task states: pending, in_progress, completed, abandoned
• Auto-normalization: Ensures exactly one task is `in_pro