Garcon 是一个自托管的可视化工作空间,用于运行编码智能体。其核心目标是让用户在浏览器中同时运行 Claude Code、Codex、Cursor Agent、OpenCode、Amp、Factory Droid 和 Pi 等多个编码智能体,协调它们的工作,并从提示一路推进到经过审查的提交,无需离开浏览器。
用途
Garcon 面向需要同时管理多个编码智能体的开发者。当多个智能体并行运行,其中一个需要审批、另一个已经完成,而它们的变更仍需要被理解和交付时,Garcon 试图保持开发循环的连贯性。它把智能体、终端、文件和 Git 等操作放在主机上、以用户自己的账户运行,并使用用户配置的智能体登录和模型端点。
主要能力
- 可视化编排:最多平铺四个可调整大小的窗口,在窗口间移动本地标签页,在持久画布上组织实时聊天,用标签驱动的看板跟踪工作,并在 Chat Map 中查看分叉、交接和委派谱系。
- 控制每一轮交互:对指令排队和重新排序,引导正在运行的工作,审批工具,回答智能体的问题,暂停队列、中断或停止而不丢失转录。
- 可见地协调智能体:在聊天之间交换带来源标记的消息,启动委派的子智能体,接收其最终结果,并保持父级关系可审计。
- 持久化工作跟踪:以列表或状态看板创建 workspace 工单,分配和认领工作,讨论进度,并在聊天删除和服务器重启后保留有归属的变更历史。
- 审查真实变更:浏览和编辑文件,运行终端,查看推理和工具调用,审查 diff,然后按行、按块、按文件或文件夹暂存,再提交和推送。
- 查找和复用上下文:搜索聊天元数据和索引转录,保存过滤器,标签、固定、归档,导出 Markdown 或 XML,构建有界交接,分享快照,以及计划提示。
- 跨屏幕使用:在桌面或手机上使用响应式工作空间,并选择 Classic、Phosphor 或色盲友好主题的浅色或深色模式。
使用方式
快速启动需要 Bun、git 和现代浏览器,以及至少一个可用的编码智能体或 API 提供方。打开 http://127.0.0.1:8080 ,首次启动时在 /setup 创建账户,然后在 Settings 中连接智能体和 API 提供方。默认启用认证。可选的拉取请求支持需要所选执行器上有已认证的 GitHub CLI。Garcon 为 main 分支的每次提交发布官方多平台容器镜像,Docker 指南涵盖运行已发布镜像、构建当前检出、镜像标签、卷、智能体登录、Git、SSH 和工具链。
CLI 可通过已在运行的服务器驱动普通的可见 Garcon 聊天,覆盖实时目录发现、同步或分离启动与恢复、引导、精确轮次等待、状态和带权限的决策、聊天元数据、转录搜索与有界读取、导出、交接和停止控制。bun run build-exe 可生成独立的 Linux x64 和 macOS arm64 可执行文件。
配套的 cfal/garcon-skills 包向 Claude、Codex、Pi 等能感知技能的智能体暴露同一控制平面:garcon-captain 搜索、读取、组织、监控和协调聊天;garcon-agent 通过 CLI 启动或恢复选定的智能体;garcon-task 启动、恢复、停止或删除委派子聊天并返回其最终输出;garcon-message 与最多 16 个现有聊天交换带内消息;garcon-schedule 为当前聊天创建未来或重复的提示;garcon-amp 为父级配备新的 Oracle、Finder、Librarian 和 Reporter 专家;garcon-ticket 从聊天管理持久 workspace 工单。
Garcon 还安装六个可编辑的 preamble:一个基于 CLI 进行聊天发现和协调的 Captain 控制室,以及聊天身份、聊天间消息、委派智能体、计划提示和工单的聊天内协议。它们被排除在自动默认值之外,但可按聊天选择。新工作区会收到全部六个;现有工作区在启动时只收到缺失条目,不会覆盖编辑或恢复已删除条目。
工单可从工作区窗口的添加菜单打开。无需启动聊天即可创建工作,可在列表和看板之间切换,按项目、状态、优先级、标签、负责人或就绪状态过滤。详情窗格在两种布局间共享属性、评论、关系和活动。设置 > Automation > Ticket chat prompt 可用 {{ticket_id}}、{{ticket_title}}、{{ticket_project}}、{{ticket_description}} 配置模板。工单存放在工作区的 tickets.sqlite 中,独立于聊天和转录。
路径前缀部署:webapp、API 和 WebSockets 可共享运行时 URL 前缀而无需重新构建前端,设置 --base-path /garcon 或 GARCON_BASE_PATH=/garcon。反向代理必须保留该前缀。
远程执行器:Garcon 可在 Local 和受信任的远程 worker 上运行智能体、文件、Git 和终端。任一侧都可发起连接,两个方向都使用经过认证的 Noise 加密 WebSocket。Worker 监听器支持原生 TLS 或显式 --no-tls 位于受保护的 TLS 代理之后。
适用场景
适用于在主机上运行编码智能体并希望集中查看、控制、审查和交付变更的开发者或团队,尤其是需要并行运行多个智能体、跟踪委派谱系、使用工单看板管理、或在手机上进行审批的场景。
限制
- Garcon 不对智能体或其命令进行沙箱隔离,审查安全说明后再在受信任网络之外暴露。
- 受信任单用户环境可禁用认证,但不要将未认证实例暴露到不受信任的网络。
- 工单草稿恢复不是备份;存储报告警告时应在关闭前复制文本。
- Claude Code 需要 2.1.238 或更高版本。
- 自定义端点必须在其模型目录中包含带精确注记的模型 ID。
- 远程执行器工作区范围的 CLI 访问是独立的、默认关闭的授权。
- 许可证为 GPL-3.0。其它未在资料中提及的定价、平台效果等信息暂未提供。