← Discover MCPs and Agents
h
MCPAI & MLGitHub

homebrew-core

HarmonyOS（OHOS aarch64）Homebrew tap：真机验证、签名开箱即用的开发工具链——AI 编码 CLI（opencode / claude-code）、Bun 运行时、Node 多版本管理、终端与调试工具；暂未回流官方 core 的 formula 在此先行，稳定后合入上游

Links

Repository

README

From the repo.

social4hyq/homebrew-core

面向鸿蒙 PC（HarmonyOS，OHOS aarch64）的 Harmonybrew（Homebrew 的鸿蒙移植）第三方 tap。

这个 tap 解决什么问题：鸿蒙 PC 终端（HiShell）强制代码签名——自行编译或直接下载的 Linux 程序一律 Permission denied，且不少常用工具还没适配鸿蒙。本 tap 逐一移植、签名、真机验证后打包成 bottle，brew install 一条命令装好即用，体验等同 macOS/Linux 上的 Homebrew。

这个 tap 的定位：过渡区——formula 从进入 tap 第一天起就以合入 Harmonybrew 官方 core 为目标，验证成熟即推动合并、下线自有版本（见下方「已下线 / 已迁移」表）。

仓库源头：本仓库以 GitHub 为唯一源头——源码托管、Issues、PR、CI 全部在 GitHub 进行。atomgit 同名仓库 是合并后自动同步的单向镜像（GitHub → atomgit，永不反向），存在意义是 bottle 二进制发布在 atomgit Releases 上、国内网络下载更快。反馈问题、提交贡献请认准 GitHub；请勿向 atomgit 推送代码或开 PR。

安装

brew tap social4hyq/core https://atomgit.com/social4hyq/homebrew-core.git
brew trust social4hyq/core   # Homebrew 6.0+ 必须显式信任第三方 tap

# 常用工具：
brew install opencode        # AI 编码代理（v2：brew install opencode-v2）
brew install claude-code     # Claude Code CLI
brew install bun             # Bun 运行时
brew install vite-plus       # VoidZero 统一前端工具链（`vp` 命令）
brew install hishell-font    # starship 图标字体（先装这个：提示符的图标/符号靠它渲染）
brew install starship        # 终端提示符美化（Harmonybrew 官方 core 原生提供，主题化 prompt，配合 hishell-font）
brew install qemu-aarch64    # 用户态 QEMU（`qemu-aarch64 -strace` 系统调用跟踪）

验证安装

bun --version && bun -e 'console.log(2**32, Math.PI)'
opencode --version
claude --version
vp --version
starship --version
qemu-aarch64 --version && qemu-aarch64 -strace /bin/true

shell 补全随安装自动装入（bash / zsh / fish），开箱即用。

Formulae

Formula版本说明
opencode1.18.31开源的终端 AI 编程助手：在终端里用自然语言让 AI 读代码、改文件、跑命令；自带 75+ 模型提供商接入，用自己的 API key 自由选模型（v1 稳定版）
opencode-v22.0.11opencode v2 稳定版：全新插件 API 与交互；与 v1 互斥（conflicts_with "opencode"，命令名同为 opencode，对齐上游官方同名 formula）：原位替代 v1，共享 ~/.config/opencode 等目录，v1 的数据库自动迁移；版本滚动跟进上游 v2 发布线（原 opencode@2，见 formula_renames.json）
claude-code2.1.267Anthropic 官方 AI 编程助手 Claude Code 的终端版：读懂整个代码库、跨文件改代码跑测试、提 PR；需 Claude 订阅或 API 账号；License 禁止再分发官方产物，故安装时从官方 npm 包拉取 CLI、剥离元文件后在本 tap 的 bun 上运行
claude-code.latest2.1.275同一 Claude Code 的 latest 滚动频道：直接运行官方 musl 二进制（自签名 + ohos-compat-shim 引导），跟进上游发版更快；与 claude-code 互斥（都装 claude 命令，二选一）
bun1.4.2极速 JavaScript/TypeScript 一体化工具链：运行时、包管理、测试、打包四合一，可直接替代 Node.js；本 tap 多数工具的底座
vite-plus0.2.8VoidZero（Vue/Vite 作者团队）的 Web 统一工具链：一个 vp 命令包揽创建项目、开发调试、检查、格式化、测试、构建全流程（Beta）
hishell-font0.1.0鸿蒙 PC 自带终端（HiShell）的 Nerd Font 图标字体：starship 等现代终端工具的图标前置——先装它，提示符里的图标才不变方框
sshport0.2.1SSH 端口转发小工具：一条命令把远程开发机的服务端口映射到本机同名端口，直接访问
ohos-compat-shim0.5.0系统兼容层：自动兜底鸿蒙与标准 Linux 的底层行为差异，让 Linux 生态软件开箱即用（已内嵌进本 tap 产物，无需单独配置）
qemu-aarch6411.0.3-r0用户态 QEMU：直接运行/调试 Linux aarch64 程序，自带系统调用跟踪（-strace），是鸿蒙无 root strace 环境下的排障替代品

已下线 / 已迁移

Formula状态替代方案
codex2026-07-23 下线已由 Harmonybrew 官方 core 原生提供，直接 brew install codex
opencode-shim / opencode-shim@22026-08-02 下线预编译 shim 路线已被源码构建路线取代，改用 opencode / opencode@2
close-range-shim2026-07-15 下线功能并入 ohos-compat-shim
bun-pty / lightningcss / tailwindcss-oxide2026-07-18 下线改走 @ohos-ports/* npm 包，无独立 formula 需求
icu4c@782026-08-09 下线libc++ ABI __n1 迁移（#239-#241）后本 tap fork 冗余，直接用上游 harmonybrew/core 的 icu4c@78（同为 __n1）
grok-build2026-08-12 下线已停止维护（使用率低）；可从 tap git 历史恢复 formula
cc-switch2026-08-12 下线已由 Harmonybrew 官方 core 原生提供（cc-switch-cli），直接 brew install cc-switch-cli
reasonix2026-08-12 下线已由 Harmonybrew 官方 core 原生提供，直接 brew install reasonix
deepseek-harness2026-08-15 下线已由 Harmonybrew 官方 core 原生提供（含 OHOS 补丁集：link 兜底 / 凭据模式 / ripgrep 回退 / crypto polyfill / 无沙箱放行），直接 brew install deepseek-harness；已装本 tap 旧版的用户请先 brew uninstall deepseek-harness 再装上游版
uv2026-08-20 下线已由 Harmonybrew 官方 core 原生提供（!17217，含全部三个 OHOS 补丁与 wheel 自动签名），直接 brew install uv；已装本 tap 旧版的用户请先 brew uninstall uv 再装上游版
codegraph2026-08-24 下线已由 Harmonybrew 官方 core 原生提供（!17567，无补丁单文件），直接 brew install codegraph；已装本 tap 旧版的用户请先 brew uninstall codegraph 再装上游版
nvm2026-08-24 下线已由 Harmonybrew 官方 core 原生提供（0.40.7，OHOS 平台补丁 + ohos-node.com 发行源），直接 brew install nvm；已装本 tap 旧版的用户请先 brew uninstall nvm 再装上游版
nvm-ohos2026-08-15 下线旧实现存档：NVM_INSTALL_THIRD_PARTY_HOOK 重定向 nvm install 到 brew node keg；其继任者本 tap nvm 也已于 2026-08-24 下线，统一改用官方 core 的 nvm；可从 tap git 历史恢复
warp-tui2026-08-12 下线已停止维护（使用率低）；可从 tap git 历史恢复 formula
inject-runpath / dlopen-sign-shim2026-08-12 下线已无 formula 依赖（原用途已被预签名 npm .so + bun r31 起静态内嵌的 ohos-compat-shim 取代）；可从 tap git 历史恢复 formula
zig@0.152026-09-04 下线唯一消费者 herdr 已改为 install() 内联官方预编译 zig（resource 下载 + binary-sign-tool 签名），独立 keg 无保留必要；可从 tap git 历史恢复 formula
llvm@21 / lld@212026-09-08 下线补丁已合入 Harmonybrew 官方 core，直接 brew install llvm@21 lld@21；bun 的构建依赖已随之改为解析上游同名 formula；已装本 tap 旧版的用户请先 brew uninstall llvm@21 lld@21 再装上游版
ohos-bst-light2026-09-08 下线Harmonybrew 官方 core 已原生提供同名 formula，直接 brew install ohos-bst-light；注意命令名变了：本 tap 旧版（v1.0.0）装的是 self-sign，官方版（v2.1.2，hqzing/ohos-bst-light 上游最新版）装的是 selfsign（无连字符），参数/行为不变（--force/--strip 均保留）；已装本 tap 旧版的用户请先 brew uninstall ohos-bst-light 再装上游版，脚本里的 self-sign 调用改成 selfsign
libsecret2026-09-08 下线OHOS 适配已合入 Harmonybrew 官方 core，直接 brew install libsecret；已装本 tap 旧版的用户请先 brew uninstall libsecret 再装上游版
zellij2026-09-08 下线OHOS 适配已合入 Harmonybrew 官方 core，直接 brew install zellij；已装本 tap 旧版的用户请先 brew uninstall zellij 再装上游版
herdr2026-09-08 下线OHOS 适配已合入 Harmonybrew 官方 core，直接 brew install herdr；已装本 tap 旧版的用户请先 brew uninstall herdr 再装上游版
starship2026-09-09 下线OHOS 适配已合入 Harmonybrew 官方 core，直接 brew install starship（配合 hishell-font 图标字体用法不变）；已装本 tap 旧版的用户请先 brew uninstall starship 再装上游版
node-ohos2026-09-09 下线Harmonybrew 官方 core 的 node 已改用 llvm@22 重编（原生 OHOS 支持，26.8.1），与本 tap 停留在 llvm@21/26.7.0 的自有版本相比无需再单独维护，直接 brew install node；已装本 tap 旧版的用户请先 brew uninstall node-ohos 再装上游 node
bun-webkit / bun-bootstrap2026-09-18 下线随 bun 1.4 切换「上游源码 + 补丁」构建（2026-09-12），bun.rb 不再依赖独立 WebKit 组件 formula 与预编译引导包，二者失去唯一消费者；formula 暂留仓库无引用，可从 tap git 历史恢复

改名提示（2026-08-01）：ohos-opencode → opencode、ohos-opencode@2 → opencode@2（命令名同步改为 opencode / opencode2）。bottle 不随改名自动迁移，已装旧名的用户请先 brew uninstall <旧名> 再 brew install <新名>。

语义变更（2026-09-22）：opencode@2 更名为 opencode-v2（对齐上游官方 formula 名，formula_renames.json 自动迁移已装用户），并对齐上游的原位替代语义——命令名从 opencode2 改回 opencode，新增 conflicts_with "opencode"（与 v1 不能同时安装），数据目录从独立的 ~/.config/opencode2 等改回与 v1 共享的 ~/.config/opencode（v1 的数据库会被 v2 自动迁移）。升级前请先 brew uninstall opencode（v1）与旧版 brew uninstall opencode@2；旧版遗留的 ~/.config/opencode2、~/.local/share/opencode2、~/.local/state/opencode2 目录升级后可手动删除。

已知限制

HarmonyOS 与 Linux 存在少量系统调用差异，本 tap 通过 ohos-compat-shim（预加载兼容层，已内嵌进 bun 及所有 bun 编译产物）自动处理，使用者一般无需关心。极端场景下可能感知到：

  • 性能：close_range/fchmodat2 等缺失的 syscall 由 shim 替换为兼容实现，高并发 IO 吞吐略低于 Linux 基线
  • 临时文件：沙箱内 /tmp 只读，tmpfile() 类调用由 shim 改走 $TMPDIR——请确保 $TMPDIR 指向可写分区
  • 用户信息：getpwuid_r() 由 shim 经 HarmonyOS 账号 API 兜底，os.userInfo() 等调用可用
  • 文件系统：硬链接当前未向三方应用开放（linkat 返回 EPERM，未加载 shim 的进程直接失败）；加载 ohos-compat-shim 的进程由 shim 自动降级为原子复制（无残留）。cwd 被删除时 getcwd() 回退到 /proc/self/cwd 解析
  • 管道 I/O：splice() 的 EOF 语义与 poll/epoll 唤醒问题已由 shim 修复，轮询型管道消费端不会死锁

上游推动：上述差异正在推动 HarmonyOS 在后续版本中解决——缺失的 syscall（如 close_range、fchmodat2）争取随系统版本放行；沙箱受限项（可写临时目录、linkat/symlinkat 权限、用户信息解析）通过权限申请开放。平台放行后 shim 会自动切回原生实现（每次调用实时探测，无需重新安装或配置）。

致谢

感谢鸿蒙生态社区热心人士的分享与贡献，为本 tap 的移植工作提供了重要参考：

  • hqzing：《鸿蒙 PC 底层开发技术详解》系列作者（代码签名机制、二进制自签名算法、问题定位手段等），开源了二进制自签工具 ohos-bst-light（本 tap 早期的自签能力即来源于此，现改用 harmonybrew/core 原生提供的同名 formula），并在《鸿蒙 PC 上可用的 AI Agent 工具汇总》中推荐了本 tap 的 OpenCode 移植版。

相关文章（CSDN）：

反馈

遇到功能差异或崩溃，请在 GitHub Issues 反馈，附：HarmonyOS 版本、bun --version、复现命令。

Collected info

  • ★ 3 stars
  • Language: Ruby
  • Source updated: 9/21/2026

Config for your environment

Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.

Tool

OS

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "{MCP_ENDPOINT_URL}"
    }
  }
}

Paste into mcpServers in the config file. Restart Cursor after saving.

If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.