Oh My Pi
Terminal AI coding agent: hash-anchored editing, LSP and browser automation
Download Oh My Pi
Zip for Apple Silicon Macs — manual install
Other downloads (1)
- Download
omp-darwin-x64
x64 · .zip · 114.1 MB
Getting a "can't verify the developer" warning?
If you see a warning on first launch, go to System Settings > Privacy & Security and click "Open Anyway". Open source software usually isn't signed with an Apple developer certificate, which is normal.
Clicking "Download" takes you to a source confirmation page first; the download starts after confirmation.
About Oh My Pi
⌥ AI Coding agent for the terminal — hash-anchored edits, optimized tool harness, LSP, Python, browser, subagents, and more
See incorrect information? Tell us
Risk notice
This project is still in rapid iteration and is maintained by the community/individual, so interfaces and configuration may change; some tools (such as GitHub, security scanning, image generation, memory, etc.) are disabled by default and need to be enabled manually. The terminal agent can execute code, access files, and control browsers/desktops. Do not run it in untrusted environments, and note that model API calls may incur costs. The raw binaries provided on this site may be unsigned or have unclear signing status, so macOS/Windows first-run security prompts may appear.
Who it's for
- Developers who work in the terminal and want to drive coding with natural language
- AI coding users who need LSP rename/diagnostics, debugger, code search, etc.
- Advanced users who like to put Python/JavaScript execution, browser control and sub-agent tasks into the same session
- Developers who use multiple AI model services and want a unified interface to switch
- Technical users willing to maintain configuration files and rules and participate in the open-source ecosystem
Who it's not for
- Users who only use graphical IDEs and are not comfortable with the command line
- Users who do not have model API keys and do not plan to use local models
- Users who need out-of-the-box behavior and are unwilling to do any initial configuration
- Teams that are not allowed by regulated environments to let AI access source code or execute commands
Install guide
Choose the executable file that matches your system and CPU architecture:
| System | Architecture | File |
|---|---|---|
| Windows | x64 | omp-windows-x64.exe |
| macOS | Apple Silicon (arm64) | omp-darwin-arm64 |
| macOS | Intel (x64) | omp-darwin-x64 |
| Linux | glibc x64 | omp-linux-x64 |
| Linux | glibc arm64 | omp-linux-arm64 |
| Linux | musl x64 | omp-linux-musl-x64 |
| Linux | musl arm64 | omp-linux-musl-arm64 |
omp-browser-relay-extension.zip is an optional browser relay extension; only use it when you need the agent to take over an existing Chrome tab.
Installation steps:
- Download the corresponding file and place it in a directory on your
PATH(e.g.,/usr/local/binorC:\bin). - On macOS/Linux, grant execute permission first:
chmod +x /path/to/omp, and it is recommended to rename it toomp. - On Windows, you can run
omp-windows-x64.exedirectly, or rename the file toomp.exeand add it to PATH. - Run
omp --helporomp setupin the terminal to start configuring your model provider.
Common issues on first run:
- macOS says "cannot be opened because the developer cannot be verified": click "Open Anyway" in System Settings → Privacy & Security, or run
xattr -d com.apple.quarantine /path/to/ompand try again. - Windows SmartScreen warning: this can happen when the binary is unsigned; click "More info → Run anyway", or use the official install script in PowerShell
irm https://omp.sh/install.ps1 | iex. - Linux musl version fails to start with missing libraries: systems such as Alpine need
libstdc++andlibgccinstalled first, i.e.,apk add libstdc++ libgcc. - For shell completions, run
omp completions bash|zsh|fishto generate them.
FAQ
Is omp free software?
Yes. omp is open source under the MIT license and can be downloaded and used for free. However, it does not include model services by itself; calling cloud models such as Anthropic and OpenAI requires the corresponding account/API key, and some services are billed by usage. You can also connect local models (such as Ollama, LM Studio) to avoid costs.
Which operating systems and CPU architectures are supported?
macOS (arm64/x64), Linux (arm64/x64, including musl) and Windows x64 are supported. Choose the corresponding binary for your platform; arm64 applies to Apple Silicon and most ARM development boards, x64 applies to Intel/AMD 64-bit devices.
How do I update to a new version?
You can rerun the official installation script (on macOS/Linux: `curl -fsSL https://omp.sh/install | sh`; on Windows: `irm https://omp.sh/install.ps1 | iex`), or use Homebrew with `brew upgrade can1357/tap/omp`, or rerun with Bun: `bun install -g @oh-my-pi/pi-coding-agent`. Manually downloading the new binary and replacing the old file also works.
What do I need to prepare before starting?
It is recommended to configure at least one model provider first. Running `omp setup` guides you through choosing a model; you can also manually edit `~/.omp/agent/models.yml` to add a custom OpenAI-compatible service. Cloud services require an API key (or OAuth sign-in); local models do not require a key.
Can I migrate configurations from other tools?
According to the project documentation, omp can directly read eight existing rule formats such as Cursor's MDC, Cline's .clinerules, and Codex's AGENTS.md, without manual conversion.