Flare
一个以代码图谱为核心的智能体 IDE:把 Claude、Codex、opencode 等编程智能体的每次改动实时画在依赖图上,供你审查、回滚与协作。
- Star 数
- ★ 309
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 58/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 同时运行多个 AI 编程智能体(如两个 Claude Code 会话加一个 Codex)的个人开发者,需要知道谁改了哪个文件、避免互相踩踏
- 不适合
- 只想要纯聊天式 AI 编程助手、不需要代码图谱与可视化协作的开发者
- 使用 Apple silicon 且需要完全稳定版本的用户(arm64 版仍为 beta 且未在真机上验证)
- 源码审查
- 58/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Flare 是一个开源(MIT)的桌面 IDE,也可从运行智能体的机器以浏览器方式访问。它的主界面是代码库的实时依赖图——每个文件是节点、导入关系是边——下方配有完整终端,你在其中运行 claude、codex 或 opencode。智能体编辑文件时图谱实时更新,每次改动会被快照进本地影子历史(独立的 GIT_DIR),可按文件或整树对比与回滚。Flare 通过内置的本地 MCP 服务器(默认端口 7345)向智能体提供 graph_overview、impact_of、tasks_list、record_intent、chat_post 等工具,并区分多个智能体(如 Claude 1、Claude 2)。它还提供看板任务、设计决策记录、问答面板、Channel 协调室、按爆炸半径分级的审查驾驶舱,以及基于 lcov 的覆盖率摄入。整体面向"人机共用一张地图"的多智能体协作场景。
Flare 用 shared/ 中的纯引擎扫描项目:导入解析器(词法 + 正则、注释/字符串安全)、模块解析器和增量图构建器生成文件级依赖图,chokidar 监听变更并原地打补丁(evt:graphPatch)。electron/core.ts 是无窗口后端,桌面主进程与浏览器服务器(server/,websocket 传输)是同一核心的两个适配器。它在终端中通过进程树监控 claude/codex/opencode/aider 等智能体,将写文件操作归属到具体智能体;同时记录所有 shell 命令并分级(读/写/验证/网络/破坏性),rm -rf、git reset --hard、push --force 等会触发告警与快照。MCP 服务器按项目暴露 …/mcp/<slug> 端点,工具包括 graph_overview、file_info、dependents、impact_of、verification_status、record_intent、tasks_list/task_get/task_update/task_create、decision_record、question_ask、working_agreement、chat_post/chat_read/agents_list、session_summary 等。审查驾驶舱将改动按作者分组为"爆发"(burst),标注验证状态(已验证/失败/验证后又改动/从未验证)、按风险分层(精读/阅读/略读)并列出智能体坏味道(如删除断言、降低覆盖率阈值)。影子历史自动提交每次改动,可单文件或整树恢复;lcov 覆盖率文件放入 coverage/ 即实时生效。
- 同时运行多个 AI 编程智能体(如两个 Claude Code 会话加一个 Codex)的个人开发者,需要知道谁改了哪个文件、避免互相踩踏
- 在 VM、dev container 或云工作机上跑智能体的工程师,用
npm run serve把 IDE 从浏览器投送到本地,终端延迟经本地回显优化 - 需要审查智能体大量改动的维护者:按爆炸半径分级精读顺序,一键回滚某个爆发或回到最后一次检查通过的状态
- 团队希望智能体先在 Channel 中声明要动的文件、把架构决策记录为待审提案、把问题挂到看板而不是阻塞
- 想了解仓库哪块最脆弱的技术负责人:用 Hotspots(改动频率×复杂度)、Risk、Cycles、Reuse 等 lens 重新着色同一张图
如何安装或部署这个 Agent?
需要 Node.js 20 或更新版本。
npm install
npm run build # esbuild 打包主进程 + vite 打包渲染进程
npm start # 启动桌面应用或下载预编译版本(GitHub Releases):Windows 提供 Flare-<version>-Windows-x64.exe(NSIS 安装器);macOS 提供 arm64/x64 beta DMG(ad-hoc 签名未公证,首次需右键打开或 xattr -dr com.apple.quarantine /Applications/Flare.app);Linux 提供 AppImage、.deb 和 .tar.gz。
浏览器/远程模式:
npm install
npm run serve # 或 npm run serve -- /path/to/project把 Flare 注册为 Claude Code 的 MCP 服务器:
claude mcp add --transport http flare http://127.0.0.1:7345/mcp/<slug>开发模式(渲染进程热重载):npm run dev。
如何使用这个 Agent?
- 启动 Flare,在起始屏选择项目文件夹(
FLARE_PROJECT=<path>可跳过起始屏直接打开)。 - 在下方终端运行你的智能体,例如
claude、codex或opencode;Flare 通过进程树识别并归属其改动。 - (推荐)点击终端栏的 Connect agent,按提示注册 MCP 端点并用提供的开场消息启动智能体,使其先调用
working_agreement了解看板与协作规则。 - 用工具栏或命令面板(Ctrl+K)切换 Canvas / Wheel / Districts 三种视图和十种 lens(Clusters、Activity、Hotspots、Risk、Tests、Coverage、Instability、Reuse、Unread、Cycles)。
- 在 Control 面板把工作写成任务卡(右键图上选区可 "New task with these files"),通过 ⚙︎ Routine 向导设定智能体没活时检查看板、记录设计决策、挂起问题等行为。
- 在 Review 驾驶舱按爆发审查改动、查看验证状态与风险分层,用时间线对比/回滚影子历史快照。
- 常用快捷键:Ctrl+K 命令面板、Ctrl+B 侧栏、Ctrl+0 适配图谱、
?查看当前视图的完整操作速查表。
这个 Agent 有哪些优点和局限?
- 图谱优先的独特视角:改动归属、爆炸半径、十种 lens 一次性呈现,不需要用 grep 人工重建影响面
- 为多智能体协作专门设计:MCP 会话身份(Claude 1 / Claude 2 / Codex 1)、Channel 声明房间、看板原子认领,避免多个智能体改同一文件的冲突被静默合并
- 审查驾驶舱超越逐文件 diff:验证状态引用终端实际输出、session_summary 会与其监视到的写操作对账、每个爆发可一键回滚
- 本地影子历史(独立 GIT_DIR 的隐藏 git 仓库)不触碰真实仓库,即"本地改动的 git"
- 一套核心同时支持桌面与浏览器/远程部署(
npm run serve),架构有tests/singleSource.test.ts强制约束
- macOS 版本仍是 beta 且 ad-hoc 签名未公证,Gatekeeper 首次启动会拒绝,arm64 包从未在实际硬件上验证过
- 需要 Node.js 20+ 和原生 node-pty 二进制模块,跨平台打包必须在目标平台上进行构建
- 终端审查依赖后端运行在智能体所在机器上,本机与远程机分离时必须改用服务器模式
- 智能体侧的价值(认领任务、Channel 发言、记录意图)依赖智能体遵守 MCP 工具描述中的约定,并非强制——Flare 自己也承认无法锁文件
- Windows 生产签名依赖 SignPath,尚待其设置审核与证书签发,目前 CI 用 test-signing
这个 Agent 与同类方案有什么区别?
README 中将 Flare 定位为与 claude、codex、opencode 等终端编程智能体配合使用(而非替代它们):你仍在 Flare 的终端里运行这些 CLI,Flare 负责把它们的改动映射到依赖图上并提供协作与审查层。文中未提及其他同类图形化 IDE 产品。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Flare 当前 | 58 · 缺口较多 | 桌面应用免费 | ★ 309 | 1 个月前 | TypeScript | Codex · Claude Code |
| Superset | 52 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 16k | 今天 | TypeScript | Codex · Claude Code |
| Gortex 代码智能引擎 | 78 · 表现良好 | 命令行工具免费 | ★ 2k | 今天 | Go | Codex · Claude Code · OpenAI API · Claude API |
| Graft 代码上下文层 | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 11k | 1 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 明确说明 Flare 监视文件系统而非拦截写入,Channel 的锁只是请求、可被忽略,且不阻止代理写入他人已声明的文件——这是有意的设计取舍,但意味着最小权限与强制约束较弱,故 least_privilege 仅 1。设计决策需人工同意/拒绝、代理不能自批,且破坏性命令(rm -rf、push --force)会告警并触发快照,user_confirmation 得 2。MCP 端点仅限 localhost、按 pid 注册、端口可配置,数据流有一定透明度,得 2。但 README 未说明敏感数据(凭据、密钥、终端输出)如何存储或脱敏,快照与命令日志持久化到本地却无加密/清理说明,sensitive_data_handling 仅 1。依赖仅 4 个运行时包且版本有下限,但无锁文件证据、无审计/SBOM/漏洞扫描说明,dependency_security 得 1。外部效应(终端执行、文件写入、MCP 工具)有分类与告警,得 2。回滚能力突出:每 burst 有快照,可按文件/burst/回退到上次通过检查的状态,rollback 得 3。来源归属:按 MCP 会话区分 Claude 1/Claude 2/Codex 1,变更归属到具体代理,source_attribution 得 2。
测试覆盖 verificationFor、lastGreen、AgentRegistry、进程检测与快照切分,逻辑自洽且有边界用例(失败后通过仍保持红、stale 判定),self_consistency 得 2。依赖可用性:package.json 列出依赖但无 lockfile 证据,原生模块 @lydell/node-pty 需按平台预构建,release 工作流也承认跨平台构建问题,dependency_availability 仅 1。失败信息:verification 状态区分 not-run/failed/stale/running/unknown 并引用输出行,failure_messages 得 2。
README 清晰面向使用 claude/codex/opencode 的开发者,场景(多代理协作、评审、任务板)描述充分,audience_and_scenarios 得 2。能力边界有说明(不能锁文件、不阻止写入、仅监视),capability_boundaries 得 2。触发精度:stop hook 每次停止只触发一次、不指向他人已开始的卡,trigger_precision 得 2。环境适配:支持 Windows/macOS/Linux 打包、浏览器服务模式,但 Intel Mac 与签名流程复杂,environment_fit 得 2。
README 结构详尽、有截图与演示,information_architecture 得 2。安装说明偏薄:仅给出 MCP 注册命令与 npm 脚本,缺少从零安装/构建的完整步骤,install_notes 仅 1。命名稳定:代理编号不复用、slug 稳定,naming_stability 得 2。示例与 FAQ:有大量示例与快捷键说明,但无独立 FAQ,examples_and_faq 得 2。已知限制有明确陈述(不能锁、不阻止写入、e2e 需本地显示),known_limitations 得 2。LICENSE 为完整 MIT,license 得 3。版本号 2.1.0 存在但无 CHANGELOG,versioning_changelog 仅 1。维护责任:发布者未经验证、仅单一作者邮箱,maintenance_responsibility 仅 1。
输出可用性:图视图、评审面板、任务板、MCP 工具输出面向实际使用,output_usability 得 2。边际价值:相对普通 IDE 提供图化依赖、多代理归属与回滚,marginal_value 得 2。成本收益:Electron 桌面应用、原生模块、多平台签名与复杂 MCP 网关带来较高部署与维护成本,cost_benefit 仅 1。
claim_traceability:README 大量功能声明,部分有测试佐证(verification、registry),但多数 UI/图算法声明无对应证据,得 1。cross_source_corroboration:README、package.json、测试、release 工作流部分互相印证,但核心图与评审逻辑无源码可见,得 1。fact_inference_separation:README 区分了“Flare 观察到的”与“代理自述的”(session_summary 审计),fact_inference_separation 得 2。
- Channel 的锁只是建议性请求,代理可忽略并写入他人已声明的文件;不要把它当作强制互斥。
- README 未说明终端输出、命令日志与快照的敏感数据处理、加密或保留策略,需自行评估本地数据暴露风险。
- 缺少 lockfile 与依赖审计证据,原生模块 @lydell/node-pty 需按平台预构建,跨平台部署可能失败。
- 发布者身份未经验证,维护责任与更新路径不明确,采用前应核实来源。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
常见问题
Flare 本身需要付费或 API key 吗?
claude/codex/opencode 时产生的模型费用属于这些智能体,与 Flare 无关。我的智能体必须接 MCP 才能用吗?
多个智能体会不会同时改坏同一个文件?
可以在远程机器上使用吗?
npm run serve,浏览器访问打印的 URL(token 存于 ~/.flare/web-token)。支持 SSH 端口转发、Codespaces、Gitpod、jupyter-server-proxy 等环境,并自动推导可用的公开 URL;--host 0.0.0.0 可开放到局域网。