企业官网建设流程全解析

omp 安装与上手完全指南：从选路到跑通验证

【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in. Built by Stencil Labs.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi

omp（项目名 oh-my-pi）是一个把 IDE 能力直接焊进终端的 AI 编码代理：60+ 模型服务商、31 个内置工具、LSP 代码智能，外加约 8 万行 Rust 原生物件，装完即用一个omp命令全搞定。它原生支持macOS、Linux、Windows，不需要 WSL。

下面这张表帮你 30 秒定路线：

无论走哪条路线，装完你拿到的都是同一个命令：omp。

三分钟装好：macOS 与 Linux 的 curl 安装

打开终端，执行：

curl -fsSL https://omp.sh/install | sh

这一条命令背后的安装脚本是 scripts/install.sh，它干的活比"下个文件"多：先识别你的架构（x64 / arm64，macOS Rosetta 会话下也能正确选出 Apple Silicon 原生版本，避免慢启动和 AVX 警告），再看你本机有没有架构匹配的 Bun——有就走包管理器安装，没有就直接拉预编译二进制放到~/.local/bin/omp。最后脚本会自己跑一次omp --version冒烟测试，二进制起不来就明确报错，不会假装成功。

三个常用变体：

# 强制走源码安装（需要 Bun） curl -fsSL https://omp.sh/install --source | sh # 源码安装并锁定某个版本（tag / 分支 / 提交），--ref 也可以写成 -r curl -fsSL https://omp.sh/install --source --ref v18.0.6 | sh # 强制下载预编译二进制 curl -fsSL https://omp.sh/install --binary | sh

⚠️ Alpine / musl 用户注意：musl 构建动态链接libstdc++和libgcc，原生 Alpine 系统不自带这两个库。先执行apk add libstdc++ libgcc再跑安装，否则二进制下载成功却起不来（exit 127 的 relocation 错误）。

跟着包管理器走：Homebrew、Bun 与 mise

Homebrew对 macOS 用户是最省心的选择，官方维护了一个 tap：

brew install can1357/tap/omp

之后升级只需brew upgrade omp，版本自动跟随上游发布。

Bun是官方 README 里标注recommended的路线。omp 就跑在 Bun 之上，要求bun ≥ 1.3.14（scripts/install.sh 里写死了这个最低版本）。装的是 npm 上的@oh-my-pi/pi-coding-agent包：

bun install -g @oh-my-pi/pi-coding-agent

原生插件以"按平台分包"的形式自动匹配你的系统（linux-x64、darwin-arm64等），不用操心。升级用bun update -g @oh-my-pi/pi-coding-agent。如果你用 mise 这类版本管理器，还能一行锁定版本：

mise use -g github:can1357/oh-my-pi

声明式玩家：Nix 安装

Nix 用户不用碰包管理器，flake 直接消费：

# 免安装，直接跑一次 nix run github:can1357/oh-my-pi # 或安装进当前 profile nix profile install github:can1357/oh-my-pi

Flake 还提供四种消费入口：packages.<system>.omp、overlays.default、nixosModules.default、homeManagerModules.default。Home Manager 用户可以把二进制连同配置一起声明式管理：

{ inputs.omp.url = "github:can1357/oh-my-pi"; imports = [ inputs.omp.homeManagerModules.default ]; programs.omp = { enable = true; settings.startup.quiet = true; }; }

打包逻辑在 nix/package.nix 里，Bun 和 Rust 工具链都是锁定版本的，构建可复现；想参与开发的话，nix develop会给出一整套构建环境，nix build .#omp则直接产出可分发的包。

Windows 免 WSL 安装

Windows 是原生支持的平台——同一个 omp 二进制直接跑在 Windows 上，不需要 WSL。在 PowerShell 中执行：

irm https://omp.sh/install.ps1 | iex

脚本 scripts/install.ps1 默认按架构下载omp-windows-x64.exe（arm64 机器则拿 arm64 版），装到%LOCALAPPDATA%\omp，并把该目录追加进用户 PATH。支持三组开关：-Source（走 Bun 源码安装）、-Binary（强制二进制）、-Ref <版本>（锁定版本，注意二进制模式只认发布 tag，分支/提交要配-Source用）。脚本要求 Windows PowerShell 5.1 及以上。

两个细节：装完如果提示"重启终端"，是因为刚把目录写进了 PATH，新开一个窗口再敲omp即可；另外脚本会顺手找 Git for Windows 的 bash 写进~/.omp/agent/settings.json，找不到也没关系，omp 自带进程内 shell，只是交互式快照类功能会受限。

验证安装：版本检查与 Shell 补全

✅ 装好后第一件事，确认命令可用：

omp --version

输出形如18.8.7（对应 packages/coding-agent/package.json 里的版本字段）即安装成功。curl / PowerShell 脚本装二进制时已经内置了这步自检，但 bun / brew / nix 装完手动敲一次最稳妥。

顺手再配一下补全。omp 能从自身的命令元数据实时生成bash / zsh / fish补全脚本——子命令、参数、模型名、会话名都能补全，而且永不与 CLI 漂移：

# zsh —— 加到 ~/.zshrc eval "$(omp completions zsh)" # bash —— 加到 ~/.bashrc eval "$(omp completions bash)" # fish —— 直接写进补全目录 omp completions fish > ~/.config/fish/completions/omp.fish

装完后的第一次体验

直接运行omp进入终端 TUI。工具调用会渲染成卡片，编辑先预览后落地；遇到歧义时代理不会瞎猜，而是调用ask工具弹出一张结构化的选项卡让你勾选：

它内置常驻的 Python 与 JavaScript 内核：代理可以在会话里加载 CSV、跑计算，甚至直接渲染一张图表返回给你，全程不离开终端。

首次启动时 omp 还会自动"发现"你机器上已有的配置：.claude、.cursor、.windsurf、.codex、.cline、.github/copilot、.vscode里的规则、技能和 MCP 服务器全部按原格式直接继承，不需要任何迁移脚本。

常见问题速答

• 装到哪个目录？curl 方式默认~/.local/bin/omp，可用环境变量PI_INSTALL_DIR覆盖；Windows 默认%LOCALAPPDATA%\omp。
• 更新怎么办？curl 装的把安装命令重跑一遍即可；Homebrew 用brew upgrade omp；Bun 用bun update -g @oh-my-pi/pi-coding-agent；Nix 走nix profile upgrade。
• 机器上没有 Bun 能装吗？能。curl 与 PowerShell 脚本在找不到 Bun 时会自动走预编译二进制；Bun 只在源码模式（--source/-Source）下必需，且要求 ≥ 1.3.14。
• Rosetta 终端下装的版本对不对？对。安装脚本在 macOS 上用sysctl hw.optional.arm64判断真实架构，Rosetta 会话里也会给你 Apple Silicon 原生二进制，而不是 x86_64 模拟版。
• Alpine 上二进制起不来？见前文：先apk add libstdc++ libgcc，再重跑omp。

选一条最顺手的路线执行完，几分钟后你的终端里就住进了一个"把 IDE 焊死进去"的 AI 编码代理。

【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in. Built by Stencil Labs.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi