fanbox

📦 FanBox

"AI 帮你一个下午起十个项目，然后它们就再也找不到了。FanBox 帮你把它们找回来。" "AI spins up ten projects in an afternoon. FanBox helps you find them again."

FanBox：Coding Agent 的驾驶舱。指挥 Claude Code、Codex 在本地干活，看清它碰过的每个文件、改过的每一行，随时接手。 FanBox — the cockpit for coding agents: command Claude Code or Codex, see every file and line they change, and take over anytime.

一边浏览、预览、编辑本地文件；一边在内嵌真实终端里跑 Claude Code 或任何 coding agent。 agent 每写一个文件，对应卡片就会亮起来——找回文件 → 运行 agent → 看清改了什么，全部在一个窗口完成。 Browse, preview and edit local files on one side; run Claude Code or any coding agent in a real embedded terminal on the other. Every time the agent writes a file, its card lights up — find files → run agents → see what changed, all in one window.

⬇ 下载 dmg / Download dmg · Screenshots / 截图 · Features / 功能 · Install / 安装 · Credits / 致谢

Why FanBox · 为什么要做 FanBox

AI 帮你一个下午起十个项目，但它们散在各处、名字认不出、改了啥看不见。每天的真实流程是：Finder 里翻半天 → 切到 iTerm 启 agent → 再切浏览器看效果，三个窗口来回跳。

AI helps you start ten projects in an afternoon — then they scatter everywhere, the names stop making sense, and you can't see what got changed. The daily reality: dig through Finder → switch to iTerm to launch an agent → switch to the browser to check results. Three windows, endless hopping.

FanBox 把这条链路收进一个窗口：左边文件 × 右边/下边终端 × 原地预览，一个有机整体。它不跟 Finder 拼文件操作，不跟 VS Code 拼编辑，专注「找回 + 预览 + 轻改 + 指挥 agent」这一条链路做到顺手。

FanBox folds that loop into one window: files on the left × terminal on the right/bottom × preview in place. It doesn't compete with Finder on file ops or VS Code on editing. It does one chain well: find → preview → light edits → command the agent.

不做云、不做远程、不做账号。本地、零配置、运行时零依赖。

No cloud, no remote, no accounts. Local-first, zero config, zero runtime dependencies.

Three skins · 三套皮肤

界面在 huashu-design 辅助下完成设计，三套皮肤不是换个主题色——配色、字体、图标、代码高亮、终端 ANSI 主题整体随之变化。

The UI was designed with huashu-design. The three skins are not theme-color swaps — palette, typography, icons, code highlighting and terminal ANSI themes all change together:

What it does · 能做什么

Files · find & preview / 文件 · 找回与预览

• ⌘K 全局模糊搜索 / Global fuzzy search — 记得名字片段就行；⌘↵ 用编辑器整包打开项目；内容:关键词 切全文搜索。
  A fragment of the name is enough; ⌘↵ opens the project in your editor; content:keyword switches to full-text search.
• 强色实体图标 / Bold solid icons — 每种文件「长得像它自己」：PDF 红、JS 黄、Markdown 蓝；照片视频按真实比例呈现。
  Every file type "looks like itself": red PDFs, yellow JS, blue Markdown; photos and videos render at true aspect ratio.
• 原地预览 / Preview in place — Markdown 渲染、HTML 实时成品、代码语法高亮、图片/视频/PDF 内嵌（HEIC 直接显示）、压缩包内容清单、透明图棋盘格垫底。
  Rendered Markdown, live HTML, syntax-highlighted code, inline images/video/PDF (HEIC included), archive content listing, checkerboard backing for transparent images.
• 缩略图加速 / Thumbnail speed — 大文件夹滚动和点击都在 0.1 秒内。
  Scrolling and clicking through large folders stays under 0.1s.
• 项目徽章 / Project badges — 文件夹卡片标 node / web / py / rs / go 徽章，一下午起的十个项目一眼认出类型。
  Folder cards show node / web / py / rs / go badges, so ten projects from one afternoon are recognizable at a glance.

Watch what the agent changed · 看 agent 改了什么

• 活的仪表盘 / A live dashboard — agent 每写一个文件，那张卡片当场荡开涟漪、按改动频率发光呼吸，agent 写到哪光走到哪。
  Every file the agent writes makes its card ripple and glow by change frequency; the light follows wherever the agent goes.
• 跟随模式 / Follow mode — 一键让文件视图 + 预览跟踪 agent 正在编辑的文件：代码随新写行高亮闪烁，HTML 边写边实时渲染（双缓冲、零白闪），Markdown 实时渲染。任何手动浏览立即把控制权交还给你。
  One click and the file view + preview track whatever file the agent edits: code scrolls with freshly written lines flashing, HTML renders as a live web page while it's being written (double-buffered, zero white flash), Markdown renders live. Any manual browsing hands control back to you instantly.
• 本回合 / This round — 一个面板看清这一回合 agent 改了哪些文件、是哪个终端里的哪个 agent 改的（按归属分组）、每个文件 +/- 多少行；点一行看 diff（Monaco 并排），每行可单独还原，顶部整回合回滚，底部保留可拖动的回放时间轴。Markdown 默认按「读者视图」左右对比渲染后的样子，图片给前后滑杆对比——验收的是产出物，不只是代码。
  One panel for the round: which files the agent changed, which terminal/agent did it, +/- per file; click for a side-by-side diff, restore any single file, roll back the whole round, scrub the replay timeline at the bottom. Markdown compares the rendered reader view, images get a before/after slider.
• diff 上写批注、直接回喂 / Comment on the diff, feed it back — 在 diff 里选几行、写一句批注，一键以「文件:行 + 围栏 + 批注」的格式粘进那个 agent 的终端（bracketed paste，不回车，最后一下由你按）。
  Select lines in the diff, write a note, and it lands in that agent's terminal as file:lines + fenced code + your note. Pasted, not submitted.

Agent cockpit · Agent 驾驶舱

• 项目记忆 / Project memory — 点开任何项目文件夹，看 AI 在这里干过什么：历史会话（你的第一句话当标题）、每次会话改过的文件、触发过的 skill；「▶ 续上」一键在内嵌终端 claude --resume / codex resume 接上当时的上下文。
  Open any project folder and see what AI did there: past sessions (your first message as the title), the files each session changed, the skills it triggered — and a "resume" button that reconnects the context via claude --resume / codex resume in the embedded terminal.
• 截图直通车 / Screenshot express — 系统截屏落盘即浮出直通卡：喂给终端里的 agent、收进项目 素材/、或先标注再发。
  Take a system screenshot and a card pops up in the corner: feed it to the terminal agent, file it into the project's 素材/ (assets) folder, or annotate before sending.
• AI 整理 / AI organize — AI 只看元数据出整理提案（不读内容、不碰文件系统），每条建议带理由、逐条勾选过人，FanBox 执行并写回滚日志、一键整体撤销。引擎可选（Claude Code / Codex），策略提示词随便改（侧栏「更多…」/ sidebar More…）。
  AI proposes a cleanup plan from metadata only (it never reads content or touches the filesystem); you approve each move; FanBox executes with a rollback log and one-click undo. Engine selectable (Claude Code / Codex), strategy prompt fully editable.
• 发版向导 / Release wizard — node 项目一键串起版本号、CHANGELOG、打包、推送、GitHub Release，整条命令序列在内嵌终端可见地跑（侧栏「更多…」/ sidebar More…）。
  For node projects: version bump, CHANGELOG promotion, build, push and GitHub Release composed into one command sequence that runs visibly in the embedded terminal.
• Skills 透视 / Skills X-ray — 本机全部 agent skills 一个视图：触发统计、健康检查、context 预算、不删文件的启停开关。
  Every agent skill on your machine in one view: trigger statistics, health checks (description truncation, missing frontmatter), context budget, enable/disable without deleting.
• Agent 用量 / Agent usage — Claude Code 官方 5h 窗口/周配额（和 /usage 同源）+ 本地 token 统计；Codex 限额快照 + 窗口重置识别。
  Claude Code official 5h window / weekly quota (same source as /usage) plus local token statistics; Codex window snapshots with reset detection.
• 磁盘占用透视 / Disk usage lens — du 口径的真实占用条形榜，可下钻，专治「电脑空间又满了」（侧栏「更多…」/ sidebar More…）。
  du-accurate bars per folder, drill-down, for the "my disk is full again" moments.

Terminal · command the agent / 终端 · 指挥 agent

• 真实内嵌终端 / A real embedded terminal — node-pty + xterm.js（WebGL 渲染），跑 Claude Code / vim / htop 不花屏，中文宽字符正确。
  node-pty + xterm.js (WebGL). Claude Code / vim / htop render correctly, CJK wide characters included.
• 拖文件进终端 / Drag files in — 从文件列表拖文件/文件夹进终端，自动插入路径喂给 agent 当上下文。
  Drop a file or folder into the terminal to insert its path as agent context.
• 路径可点击 / Clickable paths — 终端里出现的文件路径直接点击在 FanBox 打开；带空格的 macOS 截屏名、中文文件名、折行的长路径都能识别（空格边界由文件系统 stat 验证，不靠猜）。
  File paths appearing in terminal output open in FanBox on click; macOS screenshot names with spaces, Chinese filenames and wrapped long paths are all recognized (space boundaries verified by stat, not guessed).
• 选中即甩给终端 / Send selection — 预览里选一段文字，一键以「文件出处 + 围栏」格式发进终端（bracketed paste 包裹，不会被逐行误执行）。
  Select text in a preview and fling it into the terminal with file provenance + fencing (bracketed paste, never executed line by line).
• 精确的态势感知 / Exact situational awareness — FanBox 启动 Claude Code / Codex 时会挂上它们的官方 hooks（只叠加一份自己的 settings，不碰你的配置），agent 在干活、等你确认、等你输入、已完成都是精确事件，不再靠猜终端文字。没挂上 hooks 的 agent 退回原来的判定。
  FanBox attaches the official Claude Code / Codex hooks when it launches them (an extra settings file of its own, your config untouched), so working / needs approval / needs input / done are exact events instead of terminal-text guesses. Agents without hooks fall back to the old heuristics.
• 指挥台 / Command roster — 两个以上终端、且有会话在等你时，标签栏下出现一行一个「在等你的」会话（等你确认 / 等你输入 / 刚完成没看）：状态（形状 + 颜色）、项目、agent、最后一句回复、本回合改动数；没人等你整条消失，干活中的已跑时长在标签圆点的悬停提示里。⌘⌥L 跳到下一个需要你的会话，Dock 角标显示「需要你」的数量，系统通知点击直达那个标签。退出确认只拦真正在干活的 agent。
  With two or more terminals, sessions that need you (approval / input / just finished) get a row under the tab bar: state (shape + color), project, agent, last reply, files changed this round. It disappears when nobody is waiting; elapsed time for working sessions lives in the tab dot's hover. ⌘⌥L jumps to the next session that needs you, the Dock badge counts them, notifications click through to the tab. Quit only asks when an agent is actually mid-task.
• 11 个 agent 一键启动 / 11 built-in agent launchers — Claude Code、Codex、Hermes Agent、OpenClaw、Kimi Code、ZCode、opencode、pi、CodeBuddy、WorkBuddy、Qoder CLI，官方图标 + 核实过的启动命令。滑杆按钮打开设置面板勾选启用哪些（默认 Claude Code + Codex），未装的一键复制安装命令；~/.fanbox/config.json 的 agents 数组可自定义命令或追加新 agent。
  All with official icons and verified launch commands. A sliders button opens the picker (defaults: Claude Code + Codex); not-installed entries copy their install command in one click; the agents array in ~/.fanbox/config.json overrides commands or adds new agents.

Editing · WYSIWYG / 编辑 · 所见即所得

• Markdown — Milkdown Crepe 提供 Notion 式所见即所得，打开就是编辑态，停笔 0.8 秒自动保存。顶部 富文本 / 阅读 / 源码 / 排版 四档随时切；少数文件富文本往返会丢内容（校验不过），只灰掉富文本、默认落在只读阅读模式，文章照看，要改点源码。
  Milkdown Crepe, Notion-style WYSIWYG; opens in edit mode, auto-saves 0.8s after you stop typing. A Rich / Read / Source / Typeset switch sits on top; when a file can't survive a WYSIWYG round-trip, only Rich is disabled — it falls back to the rendered read-only view, not raw source.