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 快捷键。
د خپرونکي تشریح (چیني)
Belfry څه شی دی؟
Belfry د appmakes له خوا د ټرمینلونه او CLI وسایل په کټګورۍ کې راځي او خلاصه سرچینه سافټویر دی. په Rust ژبه لیکل شوی.
نصب او اړتیاوې
خپرونکی د EXE (NSIS) او MSI نصبوونکي د 64-bit Windows لپاره وړاندې کوي. یوازې د اوسني کارن لپاره، بې له اډمین اجازې نصبېدای شي. د نصبوونکي د لیکل شویو سویچونو په مرسته چوپه نصب کېدای شي. د Group Policy، Intune یا Configuration Manager له لارې د وېشلو لپاره MSI بسته شته.
تازه کېدنې او د نسخو تاریخچه
اوسنۍ نسخه 0.21.13 ده چې په AP ۱۴۰۵ تله ۱۸ خپره شوه. د نسخو تاریخچه ۳ خپرونې لري چې تر ټولو زړه یې AP ۱۴۰۵ وږی ۱۴ ته رسېږي؛ ټولې رسمي فایلونو ته لینک لري. وروستۍ تازه کېدنه له یوې میاشتې کمه زړه ده.
شهرت او د فایل ډولونه
په GitHub کې سرچینه کوډ (ChengSoon/belfry-desktop) ۲۶ ستوري لري. ورته پروګرامونه PowerShell، Oh My Posh او Tabby دي.
په GitHub کې د پروژې تشریح: “跨平台（macOS + Windows）AI 编程终端，托管 Codex / Claude Code 等 CLI Agent。Tauri 2 + Rust + React + xterm.js”
ګټې / نیمګړتیاوې
ګټې
- خلاصه سرچینه: هر څوک یې کوډ کتلی او جوړولی شي
- د منظم وېش لپاره MSI بسته
- لیکل شوی چوپه نصب
- بې له اډمین اجازې نصبېږي
- په تېرو دوو میاشتو کې تازه شوی
نیمګړتیاوې
- اصلي ARM64 نسخه نه لري
لنډه دا چې: Belfry د 64-bit کمپیوټرونو لپاره یوه خلاصه سرچینه د ټرمینلونه او CLI وسایل وسیله ده. اډمینان یې بې له لاسوهنې وېشلی شي.
ایا د Belfry ډاونلوډ خوندي دی؟
- فایل له github.com څخه راځي، چې د خپرونکي خپل ډومېن دی
- د ډاونلوډ لینک HTTPS کاروي
- SHA256 هش خپور شوی، نو فایل تایید کولی شئ:
AABBBB9A88A0B39799169F9BEC7299A4B6DA43CEB0932E1AE6A8E70A151EE3AA· د دې هش د VirusTotal راپور پرانیزئ - لینک لا نه دی کتل شوی
- سرچینه کوډ عامه دی
- ExeAtlas نصبوونکي نه ساتي، نه یې پوښي او نه یې بدلوي
اړوند لارښود: په Windows کې د فایل SHA256 هش څنګه وګورو
وروستۍ نسخې
ټولې ۳ نسخې ›| نسخه | نېټه | اندازه | فایلونه |
|---|---|---|---|
| 0.21.13وروستۍ | AP ۱۴۰۵ تله ۱۸ | — | 64-bit MSI64-bit EXE (NSIS) |
| 0.21.8 | AP ۱۴۰۵ تله ۲ | — | 64-bit MSI64-bit EXE (NSIS) |
| 0.19.0 | AP ۱۴۰۵ وږی ۱۴ | — | 64-bit MSI64-bit EXE (NSIS) |
له کمانډ لاین نه نصب
چوپه نصب ›winget install --id ChengSoon.Belfry -eBelfry_0.21.13_x64-setup.exe /Sاړوند لارښود: winget څنګه وکاروو: پروګرامونه نصب او تازه کړئ
معلومات
- خپرونکی
- appmakes
- کټګوري
- ټرمینلونه او CLI وسایل
- جواز
- LGPL-3.0-only
- بیه
- وړیا
- سرچینه کوډ
- github.com/ChengSoon/belfry-desktop
- د پروګرام ژبه
- Rust
- اړتیا
- Windows 11 / 10
- جوړښت (Architecture)
- 64-bit
- د نصبوونکي ډول
- EXE (NSIS), MSI
- نسخه
- 0.21.13
- د خپرېدو نېټه
- AP ۱۴۰۵ تله ۱۸
- لېست ته د ورزیاتېدو نېټه
- AP ۱۴۰۵ تله ۳
- لېست شوې نسخې
- 3
- د GitHub ستوري
- ۲۶
- د GitHub فورکونه
- ۳
- وېب پاڼه
- github.com
- winget ID
- ChengSoon.Belfry
- د MSI د محصول کوډ
- {F713EA13-6255-4D8E-9A9B-7FE92380D862}
درجې او نظرونه
لا تر اوسه هېڅ نظر نشته. لومړۍ درجه تاسو ورکړئ.
د Belfry بدیلونه
ټول وګورئ ›-
خلاصه سرچینه (open source)۶۸۹٫۶K ↓ -
خلاصه سرچینه (open source)۸۲۰٫۸K ↓ -
خلاصه سرچینه (open source)۸۵٫۷K ↓ -
خلاصه سرچینه (open source)۲٫۱M ↓ -
خلاصه سرچینه (open source)۷۵٫۹K ↓ -
خلاصه سرچینه (open source)۸۳۲٫۷K ↓ -
خلاصه سرچینه (open source)۵٫۳M ↓ -
خلاصه سرچینه (open source)۱٫۵M ↓
ډېرې پوښتل شوې پوښتنې
ایا Belfry وړیا دی؟
هو. Belfry خلاصه سرچینه سافټویر دی د LGPL-3.0-only جواز لاندې.
ایا د Belfry ډاونلوډ خوندي دی؟
ډاونلوډ له github.com څخه راځي، چې د خپرونکي خپل دی؛ ExeAtlas فایل نه ساتي او نه یې بدلوي. د فایل SHA256 هش له هغه سره پرتله کړئ چې دلته ښودل شوی، یا د همدې هش د VirusTotal راپور پرانیزئ.
Belfry د winget په مرسته څنګه نصب کړم؟
PowerShell یا Windows Terminal پرانیزئ او هغه winget کمانډ وچلوئ چې په دې پاڼه کې ښودل شوی. winget رسمي نصبوونکی ډاونلوډوي او له چلولو مخکې یې SHA256 هش ګوري.
ایا Belfry په چوپه توګه نصبېدای شي؟
هو. د چوپه نصب پاڼه د هر نصبوونکي دقیق کمانډ ښیي، د MSI بستې لپاره د msiexec په ګډون.
ایا Belfry په ARM (Windows on Arm) چلېږي؟
ARM64 نسخه نشته؛ Windows 11 on Arm کولی شي د 64-bit نسخه د ایمولېشن له لارې وچلوي.
د Belfry زړه نسخه له کومه ډاونلوډ کړم؟
د نسخو پاڼه ټولې ۳ نسخې د رسمي نصب فایلونو له لینکونو سره ښیي، تر AP ۱۴۰۵ وږی ۱۴ پورې.
ایا Belfry بې له اډمین اجازې کارولی شم؟
هو، د یوه کارن لپاره نصبوونکی شته چې اډمین اجازې ته اړتیا نه لري.
د Belfry بدیلونه کوم دي؟
PowerShell، Oh My Posh، Tabby، QPDF او Alacritty. د بدیلونو پاڼه یې سره پرتله کوي.
