Nimbalyst - 本地优先的可视化 Agent 工作台
Nimbalyst — 本地优先的可视化 Agent 工作台
数据采集：2026-10-23（GitHub API 实抓 + 官网/docs 实读） 仓库：https://github.com/Nimbalyst/nimbalyst ｜ 官网：https://nimbalyst.com ｜ 文档：https://docs.nimbalyst.com
一句话
给你已有的 Claude Code / Codex 配一个本地优先的可视化工作台：你和 agent 编辑同一批文件，改动以红绿 diff 逐条审批，任务和决策沉淀在纯 markdown 文件里。
前身是 stravu/crystal（多会话 AI 代码助手管理器），2026-02 已弃用，转商业化 Nimbalyst。
项目总览
| 维度 | 评价 |
|---|---|
| 项目类型 | 编码 agent 的可视化工作台（桌面应用 + iOS 伴侣 + 本地 wiki） |
| 技术壁垒 | 中 — 壁垒在编辑器和协作协议本身（Lexical / Monaco / Excalidraw / PGLite / collab-protocol），不在 AI |
| 学习价值 | 高 — “Agent Harness 八层”理念 + Extension SDK 的 EditorHost 契约，是可迁移的设计范式 |
| 商业价值 | 中高 — App 全功能免费（策略是先用免费个人版养生态），团队协作走 Wiki Teams $20/人/月 |
| 适合人群 | 想让 agent 与自己在同一批文档/规格/mockup 上共事的人；极度反感被锁定的个人开发者 |
| 核心创新 | ”团队应该拥有 harness 这一层”——Claude Code / Codex 各给 vendor harness，团队要在其上提供自己的 project harness |
硬数据（2026-10-23 GitHub API 实抓）
| 指标 | 值 |
|---|---|
| ⭐ Stars | 1,964 |
| Forks | 315 |
| Contributors | 60 |
| Open issues | 812 |
| 建仓 | 2025-10-30（约 1 年） |
| 最近推送 | 2026-10-23 ✅ 活跃 |
| 最新版本 | v0.81.7（2026-10-16 发布，近乎每日发版） |
| 主语言 | TypeScript |
| License | MIT ✅ 纯开源 |
| Topics | agentic-ai, agentic-ide, ai-agents, ai-coding-assistant, claude-code, codex |
技术栈
| 组件 | 实现 |
|---|---|
| 桌面端 | Electron + React + Jotai |
| 本地数据库 | PGLite（Postgres in WASM） |
| 富文本 | Lexical（Meta） |
| 代码编辑 | Monaco |
| 图表 | Excalidraw 集成 |
| 测试 | Playwright |
| 云基础设施 | Cloudflare Workers + Durable Objects（协作同步服务，独立项目） |
| iOS | 原生 SwiftUI |
| Monorepo | pnpm workspaces，需 Node 24（见 .nvmrc） |
主要 workspace：packages/electron（桌面）、packages/ios（SwiftUI）、packages/runtime（AI / 同步 / Lexical 运行时服务）、packages/collab-protocol（协作同步协议线格式，前后端共享）、packages/extension-sdk（扩展开发套件）、packages/extensions（内置扩展）。
核心设计
1. 视觉编辑器矩阵（这是它最独特的东西）
| 编辑器 | 说明 |
|---|---|
| Markdown | WYSIWYG，带表格 / 代码块 / embed |
| Mockups | 带批注的界面原型 |
| Mermaid | 流程图 |
| Excalidraw | 白板手绘 |
| CSV | 表格数据 |
| Data Model | 可视化数据建模 |
| Code | Monaco |
你和一个 coding agent 编辑同一批文件，agent 的流式编辑实时进编辑器。
2. 红绿 diff 审批（文档级，不只是代码级）
在渲染后的文档里逐条 step through agent 的建议改动，逐个 accept / reject。不只是看代码 diff。
3. Session 与 Task
- Session kanban：每个 session 上看板，可搜索、恢复、链接到它改过的文件；文件也能链回 session
- Task tracker：计划 / bug / feature / todo，agent 能读写（“Have the agent edit tasks, add them, move them, and execute them”），人也照常编辑
- 支持并行 session，各自隔离在独立 git worktree
4. Agent Harness 八层（理念层比功能层更值钱）
官方在 nimbalyst.com/harness/ 把”团队自己拥有的那层 harness”拆成八层，每层对应生产 coding 中的一个失败模式：
| 层 | 应对的失败模式 |
|---|---|
| 01 Context | CLAUDE.md / AGENTS.md / path-scoped 规则 / 可复用 skills / 过去决策 → 每个 session 不用重新推导 |
| 02 Provenance | tracker / 计划 / 规格 / 图表 / mockup / session / diff / 文件 / commit / 决策之间的类型化链接；“Git 记录了什么变了，Provenance 记录为什么变” |
| 03 Capability | 读日志、查运行中的 DB、驱动 UI、截图、E2E 测试闭环、MCP 包装第三方系统 |
| 04 Workflow | slash commands、plan-then-execute、investigate→design→implement、subagents、可复用 skills |
| 05 Restraint | 边界约束 |
| 06 Verification | 证明工作是对的 |
| 07 Visual interface | 视觉界面 |
| 08 Coordination | 协作 |
核心论断：Claude Code 和 Codex 各自提供 vendor harness，团队要在它们之上提供自己的 project harness；而自己拥有的 harness 才是可读、可编辑、可版本化、可移植的。
这套论证结构与 Multica 的 VISION 同源——Multica 押”人机同编一个团队”，Nimbalyst 押”团队要拥有 harness 这一层”。
5. Wiki —— agent 写的知识库
Agent Harness 的产品化载体。编码 agent 在干活时把活动蒸馏成页面（笔记、待决问题、决策记录，谁定的、何时定的），页面内容是 markdown / mockup / 图表 / 2x2 矩阵。
- 个人 wiki 免费，插件形式装进你已有的 agent（Claude Code / Codex CLI / Codex App / Cowork / Cursor / VS Code / 任意 MCP agent），不需要装 app、不需要账号
- 插件是独立仓库、MIT
- Wiki Teams（beta 期间免费，正式 $20/用户/月）：一个全队共享的实时协作 wiki，队友在浏览器里读改不装任何东西，所有人的 agent 写进同一批页面，页面全变更历史
6. Extension SDK
所有编辑器（含内置的）走同一个 EditorHost 契约，你或你的 agent 造的编辑器都是一等公民。现有扩展：Astro 网站编辑器、可视化 git log、思维导图、幻灯片、3D 物体编辑器。
7. MCP 客户端 + 服务端
可接任意 MCP server，工具结果渲染成可视 widget 而不是裸 JSON。
8. iOS 伴侣（SwiftUI）
看哪个 agent 卡住了 → 文字/语音回复，agent 立即恢复 → 滑动审批 diff → 排队下一个任务让流水线不断流 → push 通知告诉你 agent 在等你。
商业模式
| 档位 | 价格 | 内容 |
|---|---|---|
| Wiki in your coding agent | $0 | 插件装进已有 agent，agent 把 wiki 写成 repo 里的 markdown 文件；无需 app / 账号 / 信用卡；开源 |
| Nimbalyst App | $0 | 全功能桌面工作台 + 个人 wiki + 视觉编辑器 + session 管理 + tracker + git/worktree + 终端 + MCP + 扩展系统 + 移动端。无功能限制、无试用期 |
| Wiki Teams | $20 / 用户 / 月（beta 期间免费） | 全队共享 wiki，实时共同编辑，全队 agent 写同一批页面，共享类型化数据库，页面完整变更历史 |
官方 FAQ 明确：“Everything you need for personal use … No feature limits, no trial period.”
与 Multica 的策略对比：Multica Cloud 按人席位卖 Pro 档；Nimbalyst 个人版全功能永久免费，只在”多人共享 wiki”这一层收费。Agent 数量在两边都不计费。
上手
下载（macOS Apple Silicon / macOS Intel / Windows / Debian-Ubuntu .deb / 其他 Linux AppImage）：
| 平台 | 要求 |
|---|---|
| macOS Apple Silicon | macOS 12+ |
| macOS Intel | macOS 12+ |
| Windows | Windows 10+ |
| Linux（Debian/Ubuntu） | Debian / Ubuntu 或衍生版 |
| Linux（其他） | AppImage（Ubuntu 24.04+ 见 docs/LINUX_INSTALL.md） |
从源码构建：
corepack enablepnpm installcd packages/electron && pnpm run dev内置 agent：Claude Code、Codex（稳定）；OpenCode、GitHub Copilot（alpha）；另有 Gemini provider。
潜在坑
- ⭐ 只有 1,964，团队极小（60 contributors）。虽近一年活跃、几乎每日发版，但单人依赖风险高——Multica 有 357 contributors、n8n 有 836。
- 812 个 open issues 相对 1.9k star 比例很高，issue 消化压力大。
- 版本号仍 0.81.x，尚未 1.0，API/协议有变动风险（不过 collab-protocol 已独立成包）。
- 团队能力只在 Wiki Teams（beta）：没有正式的 issue 权限模型、角色、审计日志、IM 触发。agent 能读写 tracker，但不是自主领单——仍需人手动派活。这是与 Multica 最大的功能差。
- 遥测默认开启：发 PostHog 匿名使用分析。官方承诺不收用户名/邮箱/IP、文件内容与路径（只分桶）、API key、文档/session/chat 内容；随机匿名 ID 关联同一次安装；可在 Settings → Advanced → Analytics 关闭。事件清单见
docs/POSTHOG_EVENTS.md。EU/EEA/UK/瑞士访客在 opt-in 前会被拦非必要分析。 - 协作同步服务是独立项目（Cloudflare Worker，
wss://sync.nimbalyst.com），不开源但线格式协议开源（packages/collab-protocol/）——协议可读可自己实现，但服务本身不能自托管。 - 贡献需 DCO sign-off。
赛道位置
Nimbalyst 是同赛道里 license 最干净（MIT）+ 最本地优先 + 审批体验最好的一家，代价是没有企业级治理层（角色/审计/IM/自主领单）。横向对比见 [[开源项目分析/Agent协作工作台/Agent协作工作台赛道对比|Agent 协作工作台赛道对比]]。
参考
- [[开源项目分析/Agent协作工作台/Agent协作工作台赛道对比|Agent 协作工作台赛道对比]] — 四个工具的横向对比与选型
- [[开源项目分析/Agent协作工作台/Multica-人机同编的Agent协作工作台|Multica]] — 同赛道里企业治理最完整、但授权最脏的一家
- [[开源项目分析/Agent协作工作台/claude-squad-终端多Agent并行管理器|claude-squad]] — 同赛道最轻方案
- [[开源项目分析/AI编码工程化/Skill-Based-Architecture-项目级Skill编写方法论|Skill-Based Architecture]] — 项目级 Skill 编写方法论，与 Nimbalyst 的 Context 层 / skills 机制相关
- [[跨平台/Electron/Electron 优化|Electron 优化]] — Nimbalyst 桌面端是 Electron + 自定义 runtime 分层的参考实现