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 快捷键。
Përshkrimi i botuesit (kinezisht)
Çfarë është Belfry?
Botuesi i Belfry është appmakes. Është softuer me burim të hapur për Windows, në kategorinë „Terminale dhe mjete CLI”. Është shkruar në Rust.
Instalimi dhe kërkesat
Botuesi ofron instalues EXE (NSIS) dhe MSI për Windows 64-bit. Mund të instalohet vetëm për përdoruesin aktual, pa të drejta administratori. Instalimi i heshtur është i mundur me parametrat e dokumentuar të instaluesit. Ka një paketë MSI për shpërndarje me Group Policy, Intune ose Configuration Manager.
Përditësimet dhe historiku i versioneve
Versioni i fundit është 0.21.13, publikuar më 10 tetor 2026. Historiku i versioneve fillon më 5 shtator 2026: 3 publikime, të gjitha me lidhje te skedarët zyrtarë. Përditësimi i fundit është më pak se një muaj i vjetër.
Popullariteti dhe llojet e skedarëve
Kodi burimor në GitHub (ChengSoon/belfry-desktop) ka 26 yje. Programe të ngjashme janë PowerShell, Oh My Posh dhe Tabby.
Përshkrimi i projektit në GitHub: “跨平台（macOS + Windows）AI 编程终端，托管 Codex / Claude Code 等 CLI Agent。Tauri 2 + Rust + React + xterm.js”
Pikat e forta / Pikat e dobëta
Pikat e forta
- Burim i hapur: kodin mund ta shqyrtojë dhe ta kompilojë kushdo
- Paketë MSI për shpërndarje të menaxhuar
- Instalim i heshtur i dokumentuar
- Instalohet pa të drejta administratori
- Përditësuar në dy muajt e fundit
Pikat e dobëta
- Pa version vendas ARM64
Shkurtimisht: Belfry është një mjet me burim të hapur në kategorinë „Terminale dhe mjete CLI”, për kompjuterë 64-bit. Administratorët mund ta shpërndajnë pa ndërhyrje.
A është i sigurt shkarkimi i Belfry?
- Skedari shpërndahet nga github.com, domeni i vetë botuesit
- Lidhja e shkarkimit përdor HTTPS
- Është publikuar një hash SHA256, ndaj skedarin mund ta verifikoni:
AABBBB9A88A0B39799169F9BEC7299A4B6DA43CEB0932E1AE6A8E70A151EE3AA· Hapni raportin e VirusTotal për këtë hash - Lidhja ende nuk është kontrolluar
- Kodi burimor është publik
- ExeAtlas nuk ruan, nuk mbështjell dhe nuk ndryshon instalues
Udhëzues i lidhur: Si të kontrolloni hash-in SHA256 të një skedari
Versionet e fundit
Të gjitha versionet (3) ›| Versioni | Data | Madhësia | Skedarët |
|---|---|---|---|
| 0.21.13I fundit | 10 tetor 2026 | — | 64-bit MSI64-bit EXE (NSIS) |
| 0.21.8 | 24 shtator 2026 | — | 64-bit MSI64-bit EXE (NSIS) |
| 0.19.0 | 5 shtator 2026 | — | 64-bit MSI64-bit EXE (NSIS) |
Instalimi nga rreshti i komandave
Instalim i heshtur ›winget install --id ChengSoon.Belfry -eBelfry_0.21.13_x64-setup.exe /SUdhëzues i lidhur: Si përdoret winget: instalimi dhe përditësimi i programeve
Informacion
- Botuesi
- appmakes
- Kategoria
- Terminale dhe mjete CLI
- Licenca
- LGPL-3.0-only
- Çmimi
- Falas
- Kodi burimor
- github.com/ChengSoon/belfry-desktop
- Shkruar në
- Rust
- Kërkon
- Windows 11 / 10
- Arkitektura
- 64-bit
- Instaluesi
- EXE (NSIS), MSI
- Versioni
- 0.21.13
- Publikuar
- 10 tetor 2026
- Shtuar në katalog
- 25 shtator 2026
- Versione në listë
- 3
- Yje në GitHub
- 26
- Forke në GitHub
- 3
- Faqja e internetit
- github.com
- ID winget
- ChengSoon.Belfry
- Kodi i produktit MSI
- {F713EA13-6255-4D8E-9A9B-7FE92380D862}
Vlerësime dhe komente
Ende nuk ka komente. Bëhuni i pari që e vlerësoni.
Alternativa për Belfry
Shiko të gjitha ›-
Me burim të hapur689,6 mijë ↓ -
Me burim të hapur820,8 mijë ↓ -
Me burim të hapur85,7 mijë ↓ -
Me burim të hapur2,1 mln ↓ -
Me burim të hapur75,9 mijë ↓ -
Me burim të hapur832,7 mijë ↓ -
Me burim të hapur5,3 mln ↓ -
Me burim të hapur1,5 mln ↓
Pyetjet më të shpeshta
A është Belfry falas?
Po. Belfry është softuer me burim të hapur me licencën LGPL-3.0-only.
A është i sigurt shkarkimi i Belfry?
Shkarkimi vjen nga github.com, që i përket botuesit; ExeAtlas nuk e ruan dhe nuk e ndryshon skedarin. Krahasoni hash-in SHA256 të tij me atë që tregohet këtu, ose hapni raportin e VirusTotal për këtë hash.
Si ta instaloj Belfry me winget?
Hapni PowerShell ose Windows Terminal dhe ekzekutoni komandën winget që tregohet në këtë faqe. winget shkarkon instaluesin zyrtar dhe kontrollon hash-in SHA256 para se ta ekzekutojë.
A mund të instalohet Belfry në heshtje?
Po. Faqja e instalimit të heshtur jep komandën e saktë për çdo instalues, përfshirë msiexec për paketën MSI.
A funksionon Belfry në ARM (Windows on Arm)?
Nuk ka version ARM64; Windows 11 on Arm mund ta ekzekutojë versionin 64-bit përmes emulimit.
Ku mund të shkarkoj një version të vjetër të Belfry?
Faqja e versioneve rendit të 3 versionet me lidhje te skedarët zyrtarë të instalimit, që nga 5 shtator 2026.
A mund ta përdor Belfry pa të drejta administratori?
Po, ka një instalues për përdoruesin aktual që nuk kërkon të drejta administratori.
Cilat janë alternativat e Belfry?
PowerShell, Oh My Posh, Tabby, QPDF dhe Alacritty. Faqja e alternativave i krahason.
