can1357/oh-my-pi

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/can1357/oh-my-pi.svg?style=card)](https://bestofgithub.dev/repo/can1357/oh-my-pi)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/can1357/oh-my-pi.svg)](https://bestofgithub.dev/repo/can1357/oh-my-pi)

Loading README…

model	metric	what
Grok Code Fast 1	6.7% → 68.3%	Tenfold lift the moment the edit format stops eating the model alive.
Gemini 3 Flash	+5 pp	Over str_replace — beats Google's own best attempt at the format.
Grok 4 Fast	−61% tokens	Output collapses once the retry loop on bad diffs disappears.
MiniMax	2.1×	Pass rate more than doubles. Same weights, same prompt.

provider	auth
`auto`	chain
`perplexity`	`PERPLEXITY_API_KEY` (anonymous fallback)
`gemini`	oauth
`anthropic`	oauth
`codex`	oauth
`xai`	oauth or `XAI_API_KEY`
`zai`	`ZAI_API_KEY`
`exa`	`EXA_API_KEY` (or mcp)
`tinyfish`	`TINYFISH_API_KEY`
`jina`	`JINA_API_KEY`
`kagi`	`KAGI_API_KEY`
`tavily`	`TAVILY_API_KEY`
`firecrawl`	`FIRECRAWL_API_KEY` (keyless fallback)
`brave`	`BRAVE_API_KEY`
`kimi`	`/login kimi-code` or search key
`parallel`	`PARALLEL_API_KEY`
`synthetic`	`SYNTHETIC_API_KEY`
`searxng`	self-hosted
`duckduckgo`	no key
`startpage`	no key
`google`	no key (browser)
`ecosia`	no key (browser)
`mojeek`	no key (browser)
`public`	no key (all of the above, consolidated)

Crate	What it does	~LoC
pi-shell	Embedded bash engine · persistent sessions · in-process coreutils dispatch · minimizer	38,000
pi-natives	The N-API surface — every module in the table below	25,000
pi-walker	Parallel walker · listing cache · glob · regex search for natives and shell rg/grep/fd	11,400
pi-iso	Workspace isolation · apfs · btrfs · zfs · reflink · overlayfs · projfs · rcopy	3,300
pi-ast	tree-sitter + ast-grep matching, block resolution, structural summaries	2,900
pi-voice	Audio capture/playback · Opus · live WebRTC	1,000

Module	What it does	Powered by	~LoC
desktop	Window/display enumeration · screenshot · native input · AX tree for `computer`	xcap · enigo · OS AX FFI	10,600
grep	Regex search · parallel/sequential · glob & type filters · fuzzy find	grep-regex · grep-searcher	3,280
text	ANSI-aware width · truncation · column slicing · SGR-preserving wrap	unicode-width · segmentation	2,070
snapcompact	Bitmap-frame rasterization + PNG encode for context compression	image · png	1,760
keys	Kitty keyboard protocol with xterm fallback · PHF perfect-hash lookup	phf	1,740
ast	ast-grep pattern matching and structural rewrites	ast-grep-core	1,510
diff	Structured file diffing for tools and previews	in-tree	1,030
pty	Native PTY allocation for sudo · ssh interactive prompts	portable-pty	630
crash_handler	Native crash capture and reporting	in-tree	610
highlight	Syntax highlighting · 11 semantic categories · 30+ aliases	syntect	550
appearance	Mode 2031 + native macOS dark/light via CoreFoundation FFI	core-foundation	450
task	Blocking work on libuv thread pool · cancellation · timeout · profiling	tokio · napi	440
glob	Discovery with glob · type filters · mtime sort · gitignore respect	ignore · globset	430
fd	Filesystem walker for find-tool replacement	ignore	385
clipboard	Text copy and image read from system clipboard · no xclip/pbcopy	arboard	370
workspace	Workspace walker with gitignore + AGENTS.md discovery in one pass	ignore	275
power	macOS power-assertion API for idle/system/display-sleep prevention	IOKit FFI	270
prof	Circular buffer profiler with folded-stack and SVG flamegraph output	inferno	240
file_lock	Cross-process advisory file locking	in-tree	210
ps	Cross-platform process-tree kill and descendant listing	libc · libproc · CreateToolhelp32Snapshot	195
tokens	O200k / Cl100k BPE token counting · both tables embedded	tiktoken-rs	70
html	HTML to Markdown with optional content cleaning	html-to-markdown-rs	60
sixel	Terminal image rendering · decode PNG · JPEG · WebP · GIF · resize · SIXEL encode	icy_sixel · image	55

omp tool	ACP route
`bash`	`terminal/create + terminal/output`
`read`	`fs/read_text_file`
`write`	`fs/write_text_file`
`edit, bash`	`session/request_permission`

Package	Description
@oh-my-pi/collab-web	Browser guest client, mock host, and local relay for collab live sessions
@oh-my-pi/pi-ai	Multi-provider LLM client with streaming and model/provider integration
@oh-my-pi/pi-catalog	Model catalog: bundled model database, provider descriptors, and identity
@oh-my-pi/pi-agent-core	Agent runtime with tool calling and state management
@oh-my-pi/pi-coding-agent	Interactive coding agent CLI and SDK
@oh-my-pi/pi-tui	Terminal UI library with differential rendering
@oh-my-pi/pi-natives	N-API bindings for grep, shell, image, text, syntax highlighting, and more
@oh-my-pi/omp-stats	Local observability dashboard for AI usage statistics
@oh-my-pi/omptype	ArkType-compatible schema validation with lazy JIT compilation
@oh-my-pi/pi-utils	Shared utilities (logging, streams, dirs/env/process helpers)
@oh-my-pi/pi-wire	Shared collab live-session protocol types and relay constants
@oh-my-pi/pi-mnemopi	Local SQLite memory engine for omp agents
@oh-my-pi/snapcompact	Bitmap-frame context compression package and SQuAD eval suite
@oh-my-pi/browser-relay	Chrome extension that lets the Eval browser API drive your existing tabs
@oh-my-pi/pi-metaharness	Unified benchmark runners, Harbor run storage, REST/SSE API, live dashboard
@oh-my-pi/typescript-edit-benchmark	Edit benchmark suite built on TypeScript source mutations

Crate	Description
pi-natives	Core Rust native addon (N-API `cdylib`) used by `@oh-my-pi/pi-natives`; aggregates the crates below
pi-shell	Embedded shell / PTY / process management split out of `pi-natives` (wraps `brush-*`)
pi-ast	tree-sitter-based code summarizer and AST utilities (50+ language grammars)
pi-iso	Task isolation backend resolver: APFS clones, btrfs/zfs reflinks, overlayfs, projfs, rcopy
pi-voice	Audio capture/playback, Opus codecs, and live WebRTC streaming primitives
pi-walker	Parallel ignore-aware walker, directory-listing cache, glob, and content search for natives + shell
pi-edit	Edit engine behind the `edit` tool: line-anchored patch/hashline modes, streaming previews, atomic apply
brush-core	Vendored fork of brush-shell for embedded bash execution
pi-builtins	Bash builtins (cd, echo, test, printf, read, export, …) plus 67 in-process command-line utilities

Install

Shell completions

Every tool, benchmaxxed.

The Pi you love, with batteries included.

01 · Code execution w/ tool-calling

02 · LSP wired into every write

03 · Drives a real debugger

04 · Time-traveling stream rules

05 · First-class subagents

06 · A second model, watching every turn.

07 · Hand someone the link, they're in.

08 · Read a pdf on arxiv, why not?

09 · Unapologetically native. Even on Windows.

10 · Code review with priorities and a verdict

11 · Hashline: edit by content hash

12 · GitHub is just another filesystem

13 · Memory the agent curates

14 · ACP: editor-drivable agent

15 · Inherits what your other tools already wrote

16 · omp commit: atomic splits, validated messages

17 · Read PRs. Walk skills. Pull JSON out of subagents.

18 · Conflict resolution, made easy.

19 · Preview, then accept.

20 · Drives a real browser. Or your Slack?

21 · Hands on the desktop itself

Whatever the task needs, it's already in the box.

Prompt controls

Session controls

Sixty-plus providers, a thousand models, one /model away.

Frontier APIs

Coding plans

Run it yourself

Custom OpenAI-compatible providers

Four knobs that make routing useful

Twenty-three backends. One tool the agent already knows.

Search providers

Specialised handlers

Security databases

Roughly ~80,000 lines of Rust, doing the work other harnesses shell out for.

Four entry points: interactive, one-shot, RPC, and ACP.

Interactive — when in doubt, the agent asks

SDK — embed in Node

RPC — drive over stdio

ACP — speak to editors

A harness worth keeping is one you don't outgrow.

Primitives

Discovery

Extensibility

Philosophy

Project inputs and trust

Development

Getting started from source

Debug Command

Monorepo Packages

Rust Crates

Contributing

License