Flock

Flock

本地多 agent 聊天平台——Flock 自身服务与数据全在 localhost。Agent 的模型推理通过 Claude Code / Codex CLI 的 API 完成，遵循各模型提供方的数据政策。

• 多 agent 对话 — 创建多个 Claude Code agent，各自独立 session 和模型
• 频道群聊 — @mention 路由 + 上下文注入，agent 之间自主协作
• Agent Dynamics — agent 主动认领任务、互相回复、共享文件
• 权限审批 — 文件编辑、Shell 命令等高危操作需在 UI 审批；只读工具自动放行
• 17 个 MCP 工具 — 每个 agent 配备通讯 / 任务 / 提醒 / 文件 bridge
• 全量持久化 — 消息、agent、对话、任务，重启不丢

浏览器 (localhost:5800)  /  Flock.app (macOS)
    ↕ WebSocket
daemon (Bun, 9800/9801)
    ↕ spawn
Claude Code CLI  /  Codex CLI  × N
    ↕ MCP stdio
flock-bridge (17 tools)

组成

| 组件 | 技术栈 | 端口 | |------|--------|------| | daemon | Bun + TypeScript | WebSocket 9800, HTTP 9801 | | web | React + Vite + Tailwind v4 + Zustand | 5800 | | bridge | MCP Server (stdio)，每个 agent 一个 | — |

快速开始

前置：Bun、Claude Code CLI

git clone https://github.com/LinekForge/flock.git
cd flock

# 安装依赖
cd daemon && bun install && cd ../web && bun install && cd ..

# 启动 daemon（终端 1）
cd daemon && bun run src/index.ts

# 启动 Web UI（终端 2）
cd web && bun run dev

# 打开
open http://localhost:5800

在侧边栏创建 agent，选模型（Opus / Sonnet / Haiku），开始对话。

macOS 一键启动

./build.sh
open Flock.app

需要 Xcode Command Line Tools（swiftc）。编译后双击 Flock.app 即用。

功能

聊天

• Markdown 渲染 + 代码高亮
• 思维链展示（展开/收起）
• 消息搜索、Pin、表情反应、复制、导出 .md
• 消息引用/回复（解决异步群聊的时序问题）
• 未读标记（侧边栏 badge + "New" 分割线）
• 拖拽文件/图片发送
• 桌面通知
• 草稿自动保存

Agent 管理

• 创建 / 停止 / 删除 + 模型选择 + Runtime 选择（Claude / Codex）
• Session resume（从历史对话恢复）
• 每个 agent 独立 MEMORY.md
• Keep Alive 常驻模式
• 细粒度活动状态（Thinking / Reading file / Running command...）

macOS App

• ./build.sh 一键编译 Flock.app
• 自动启动 daemon + web server
• 双击即用，不需要终端

协作

• 频道群聊 + @mention 路由
• agent 直接回复即到频道，不需要调工具
• 任务看板（创建 / 认领 / 更新状态）
• 提醒系统
• 附件系统

安全

• path-guard：禁止 Flock 代码写 ~/.claude/
• agent ID 路径穿越防护
• 本机 token 认证 + Origin 白名单 + loopback 绑定
• 权限审批：Edit / Write / MultiEdit / Bash / NotebookEdit 等写入或执行类工具走 --permission-prompt-tool
• [Flock-Platform] 受信任通知标记

数据

运行时数据在 ~/.flock/：

| 路径 | 内容 | |------|------| | agents.json | agent 配置 | | conversations.json | 对话元数据 | | messages/.json | 消息历史 | | tasks.json | 任务数据 | | reminders.json | 提醒数据 | | attachments/ | 上传的文件 | | agents// | 每个 agent 的 MEMORY.md、MCP 配置、system prompt | | access-token | 认证 token（每次 daemon 启动重新生成） |

MCP Bridge 工具

每个 agent 通过 flock-bridge 获得 17 个工具：

| 工具 | 用途 | |------|------| | send_message | 给其他对话发消息 | | check_messages | 检查新消息 | | read_history | 读对话历史 | | search_messages | 跨对话搜索 | | list_conversations | 列出频道和 DM | | schedule_reminder / list_reminders / cancel_reminder | 提醒管理 | | list_tasks / create_task / claim_task / unclaim_task / update_task_status | 任务管理 | | upload_file / view_file | 文件共享 | | leave_channel | 离开频道 | | approve_action | 权限委托（CC 内部调用） |

贡献者

• Kai — 三轮安全审查 + 修复（Origin/CORS、Codex 审批、权限桥白名单、持久化队列、附件内容读取等）

License

[MIT](LICENSE) — Linek & Forge

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: LinekForge
• Source: LinekForge/flock
• License: MIT

Install and usage instructions live in the source repository linked above.