Belfry 是一款支持 macOS 与 Windows 的跨平台终端，用于托管 Codex、Claude Code 等 CLI 编程智能体。它提供项目工作区、Agent 检测与状态跟踪、支持排队的提示词编辑器、服务提供商切换、SSH 会话以及 token 用量统计。没有安装 Agent 时，它依然是一个完整的终端。
功能
项目工作区
- 打开本地目录作为项目，记住最近打开过的
- 侧栏按项目分组，可折叠，宽度可拖拽（⌘B 整体收起）
- 会话自带项目归属，不同会话可以指向不同目录
- Quick Open（⌘K）可搜索并切换会话、打开最近项目或执行常用工作区动作
- 文件预览窗格可浏览当前项目目录，打开只读代码预览；终端输出中的文件路径可直接跳转，并提示磁盘变更
Agent 托管
- 自动检测 Codex 与 Claude Code：可执行文件路径、版本号，不可用时给出原因
- 会话状态区分进程生命周期（创建中/运行/已退出/出错）与当下行为（闲着/正在输出/等你选）
- 标签标题从你的第一句输入里提取，完整原文留在 tooltip
- 协作任务按目标 Agent 分别排队；Agent 忙碌或等待确认时暂缓投递，回到空闲后按顺序发送
活动通知
- 只有两件事值得打断你：Agent 把活干完了，或者它卡在一个非你点头不可的问题上
- 完成通知压 1500 ms 再发。activity 是扫屏幕文本猜出来的，正在输出 → 闲着 → 等你选 这条路很常见（spinner 先消失，权限框隔一拍才画出来），抢在中间发一条「已跑完」就是纯误报
- 你正盯着那条会话看的时候不弹——他已经看见了
- 状态放标题、身份放正文：先判断要不要现在去处理，其次才是哪条会话
- 未读数汇总到 Dock / 任务栏角标，回到应用自动清
Provider 切换
- 在官方端点与第三方中转之间切换 Codex / Claude Code 的路由，改的是 CLI 自己的配置文件，所以在 Belfry 之外直接敲 claude、codex 一样生效
- 精准字段改写：只动 ANTHROPIC_BASE_URL 这类路由键和 [model_providers.belfry] 这张表，你的 hooks、MCP 定义、项目信任记录逐字不动
- 首次打开时把配置文件里已有的设置收编成一条可切回的条目，不会静默覆盖
- 切到三方 provider 前先备份 Codex 的 ChatGPT 登录态，切回官方时原样还原
- 检测会盖过配置文件的 ANTHROPIC_* / OPENAI_* 环境变量并给出提示
终端
- 基于 xterm.js，WebGL renderer——块字符之间没有横缝
- macOS 走 Unix PTY，Windows 走 ConPTY；Shell 依次探测 PowerShell、%ComSpec%、cmd.exe
- SSH 会话直接拉起系统 OpenSSH 客户端：密码、主机指纹、2FA 都在终端里原生交互， ~/.ssh/config 的别名、密钥和 agent 原样继承
- 连接时勾选「记住密码」，密码存进系统钥匙串（macOS Keychain / Windows 凭据管理器）， 之后的连接自动填入；SSH 表单里可随时清除已保存的密码
- OSC 10/11 颜色查询在 Rust 侧直接应答。这件事绕不过去：Codex 这类 TUI 只给 100 ms 窗口，走一圈 PTY → IPC → xterm.js → IPC → PTY 经常超时，而 Windows 上超时的后果不是「没颜色」而是「猜错颜色」——Codex 会退回读 ConPTY 的黑色调色板，把输入框画成黑块
- 密码提示识别，输入不回显
- ⌘F 搜索当前终端内容，支持跨换行匹配；HTTP(S) 地址可点击打开；CJK、组合字符和 emoji 按正确宽度显示
用量统计
- 直接读本地 Codex / Claude 会话日志聚合，不发任何网络请求
- 四类 token 归一口径：input（不含缓存命中）、cachedInput、cacheWrite、output
- 按模型、按项目两个维度拆分；时间窗口可选近 7 天 / 近 30 天 / 全部
- 配额窗口与套餐类型（目前只有 Codex 的日志带这些字段，Claude 的不带）
外观
- 亮/暗主题切换，主题色同步喂给终端调色板
- 全应用字体与 10–20px 字号同步自定义，支持本机已安装字体
- 可导入多个 TTF / OTF / WOFF / WOFF2 字体，分别切换或删除，并可随时切回系统字体
- 内置 JetBrains Mono 与 HarmonyOS Sans SC
Belfry 快捷键：⌘T 新建 Shell，⌘B 折叠侧栏，⌘K 打开 Quick Open，⌘U 开关用量，⌘⇧H 开关历史， ⌘, 打开设置，⌘1–9 切换会话，⌘/ 打开快捷指令。Windows / Linux 统一使用 Ctrl+Shift 组合，避免占用 Codex 与 Claude 的原生 Ctrl 快捷键。
Maelezo ya mchapishaji (Kichina)
Belfry ni nini?
Programu Belfry inachapishwa na appmakes. Ni programu ya chanzo huria ya Windows iliyo katika kundi la “Terminali na zana za CLI”. Imeandikwa kwa Rust.
Usakinishaji na mahitaji
Mchapishaji hutoa visakinishi vya EXE (NSIS) na MSI kwa Windows ya 64-bit. Inaweza kusakinishwa kwa mtumiaji wa sasa pekee, bila haki za msimamizi. Usakinishaji kimya unawezekana kwa swichi zilizoandikwa za kisakinishi. Kuna kifurushi cha MSI cha kusambaza kupitia Group Policy, Intune au Configuration Manager.
Masasisho na historia ya matoleo
Toleo la sasa ni 0.21.13, lililotolewa 10 Oktoba 2026. Historia ya matoleo inarudi nyuma hadi 5 Septemba 2026: matoleo 3, yote yakiwa na viungo vya faili rasmi. Sasisho la mwisho lina umri wa chini ya mwezi mmoja.
Umaarufu na aina za faili
Msimbo chanzo kwenye GitHub (ChengSoon/belfry-desktop) una nyota 26. Programu zinazofanana ni pamoja na PowerShell, Oh My Posh na Tabby.
Maelezo ya mradi kwenye GitHub: “跨平台（macOS + Windows）AI 编程终端，托管 Codex / Claude Code 等 CLI Agent。Tauri 2 + Rust + React + xterm.js”
Faida / Hasara
Faida
- Chanzo huria: mtu yeyote anaweza kukagua na kujenga msimbo
- Kifurushi cha MSI kwa usambazaji unaosimamiwa
- Usakinishaji kimya umeelezwa
- Inasakinishwa bila haki za msimamizi
- Imesasishwa ndani ya miezi miwili iliyopita
Hasara
- Hakuna toleo asili la ARM64
Kwa ufupi: Belfry ni zana ya chanzo huria ya kundi la “Terminali na zana za CLI” kwa kompyuta za 64-bit. Wasimamizi wa mifumo wanaweza kuisambaza bila maswali.
Je, ni salama kupakua Belfry?
- Faili inatolewa na github.com, kikoa cha mchapishaji mwenyewe
- Kiungo cha kupakua kinatumia HTTPS
- Hashi ya SHA256 imechapishwa, hivyo unaweza kuthibitisha faili:
AABBBB9A88A0B39799169F9BEC7299A4B6DA43CEB0932E1AE6A8E70A151EE3AA· Fungua ripoti ya VirusTotal ya hashi hii - Kiungo bado hakijakaguliwa
- Msimbo chanzo uko wazi kwa umma
- ExeAtlas haihifadhi, haifungi wala haibadilishi visakinishi
Mwongozo unaohusiana: Jinsi ya kukagua hashi ya SHA256 ya faili kwenye Windows
Matoleo ya karibuni
Matoleo yote 3 ›| Toleo | Tarehe | Ukubwa | Faili |
|---|---|---|---|
| 0.21.13Jipya zaidi | 10 Oktoba 2026 | — | 64-bit MSI64-bit EXE (NSIS) |
| 0.21.8 | 24 Septemba 2026 | — | 64-bit MSI64-bit EXE (NSIS) |
| 0.19.0 | 5 Septemba 2026 | — | 64-bit MSI64-bit EXE (NSIS) |
Kusakinisha kwa mstari wa amri
Usakinishaji kimya ›winget install --id ChengSoon.Belfry -eBelfry_0.21.13_x64-setup.exe /SMwongozo unaohusiana: Jinsi ya kutumia winget: sakinisha na sasisha programu
Taarifa
- Mchapishaji
- appmakes
- Kategoria
- Terminali na zana za CLI
- Leseni
- LGPL-3.0-only
- Bei
- Bure
- Msimbo chanzo
- github.com/ChengSoon/belfry-desktop
- Imeandikwa kwa
- Rust
- Inahitaji
- Windows 11 / 10
- Usanifu
- 64-bit
- Kisakinishi
- EXE (NSIS), MSI
- Toleo
- 0.21.13
- Ilitolewa
- 10 Oktoba 2026
- Iliongezwa kwenye orodha
- 25 Septemba 2026
- Matoleo yaliyoorodheshwa
- 3
- Nyota za GitHub
- 26
- Forks za GitHub
- 3
- Tovuti
- github.com
- Kitambulisho cha winget
- ChengSoon.Belfry
- Msimbo wa bidhaa wa MSI
- {F713EA13-6255-4D8E-9A9B-7FE92380D862}
Ukadiriaji na maoni
Bado hakuna maoni. Kuwa wa kwanza kuikadiria.
Mbadala wa Belfry
Ona zote ›-
Chanzo huriaelfu 689.6 ↓ -
Chanzo huriaelfu 820.8 ↓ -
Chanzo huriaelfu 85.7 ↓ -
Chanzo huriaM2.1 ↓ -
Chanzo huriaelfu 75.9 ↓ -
Chanzo huriaelfu 832.7 ↓ -
Chanzo huriaM5.3 ↓ -
Chanzo huriaM1.5 ↓
Maswali yanayoulizwa mara kwa mara
Je, Belfry ni bure?
Ndiyo. Belfry ni programu ya chanzo huria chini ya leseni ya LGPL-3.0-only.
Je, ni salama kupakua Belfry?
Faili inapakuliwa kutoka github.com, ambayo ni ya mchapishaji mwenyewe; ExeAtlas haihifadhi wala haibadilishi faili. Linganisha hashi yake ya SHA256 na ile iliyoonyeshwa hapa, au fungua ripoti ya VirusTotal ya hashi hiyo.
Jinsi ya kusakinisha Belfry kwa winget?
Fungua PowerShell au Windows Terminal na uendeshe amri ya winget iliyoonyeshwa kwenye ukurasa huu. winget hupakua kisakinishi rasmi na kukagua hashi yake ya SHA256 kabla ya kukiendesha.
Je, Belfry inaweza kusakinishwa kimya?
Ndiyo. Ukurasa wa usakinishaji kimya unaonyesha amri kamili kwa kila kisakinishi, ikiwemo msiexec kwa kifurushi cha MSI.
Je, Belfry inafanya kazi kwenye ARM (Windows on Arm)?
Hakuna toleo la ARM64; Windows 11 on Arm inaweza kuendesha toleo la 64-bit kupitia uigaji (emulation).
Wapi pa kupakua toleo la zamani la Belfry?
Ukurasa wa matoleo unaorodhesha matoleo 3 yote pamoja na viungo vya faili rasmi za kisakinishi, kuanzia 5 Septemba 2026.
Je, Belfry inaweza kutumika bila haki za msimamizi?
Ndiyo, kuna kisakinishi cha mtumiaji mmoja kisichohitaji haki za msimamizi.
Ni programu gani mbadala wa Belfry?
PowerShell, Oh My Posh, Tabby, QPDF na Alacritty. Ukurasa wa mbadala unazilinganisha.
