AgentsMesh 新手必读AgentPod、Runner、Workspace、Ticket 四大核心概念清单【免费下载链接】AgentsMeshThe AI Agent Workforce Platform. Run a hundred AI coding agents across your own machines — schedule, isolate, and steer them all from one console.项目地址: https://gitcode.com/gh_mirrors/ag/AgentsMeshAgentsMesh 是一个 AI Agent 劳动力平台AI Agent Workforce Platform让你在自己的机器上调度、隔离并指挥上百个 AI 编程 Agent。阅读本文你将快速掌握 AgentsMesh 的四大核心概念AgentPodAgent 执行容器、Runner自托管运行守护进程、Workspace隔离沙箱与Ticket看板工作项这是上手 AgentsMesh 最短路径的概念清单。AgentsMesh 是什么一图看懂整体思路AI 编程 Agent如 Claude Code、Codex CLI已经能大幅提升单个开发者的效率但一个人 一个 Agent很快会遇到天花板上百个 Agent 塞不进一台笔记本没人能同时盯着上百个终端窗口每个 Agent 都需要干净、隔离的工作环境否则会互相污染状态长时间运行的 Agent 会卡住、悄悄死亡无人知晓AgentsMesh 就是补上控制层的开源平台把调度、隔离、保活、协作全部整合到一个控制台Web / 桌面 / iOS详见 README.md。 一句话理解AgentsMesh 一个控制台 一群运行在你自己机器上的 Agent。你的代码永远不离开自己的基础设施。AgentPod每个 AI Agent 的独立工位AgentPodPod是 AgentsMesh 中最核心的执行单元——它是单个 Agent 的隔离运行环境包含三样东西组成部分作用PTY 终端Agent 的工作台可实时看到全部输出Git Worktree 沙箱每个 Pod 独享的代码副本与分支实时输出流通过 WebSocket 推送到 Web/桌面/iOS 控制台对新手来说只需要记住创建 Pod 派一个 Agent 开工。你可以在控制台为 Pod 选择 Agent 类型Claude Code、Codex CLI、Gemini CLI、Aider、OpenCode 或任意终端型自定义 Agent多个 Pod 可并行运行在不同 Runner 上互不干扰Pod 有完整生命周期创建 → 运行 → 结束/终止状态变更实时推送相关 API 可在 docs/api/README.md 中的 Pods 小节查到例如POST /api/v1/orgs/{slug}/pods创建 Pod与POST /api/v1/orgs/{slug}/pods/{key}/terminate终止 Pod。Runner部署在你机器上的执行守护进程Runner 是 AgentsMesh 的自托管守护进程daemon安装在你的电脑、服务器或任何 Linux/macOS/Windows 机器上负责真正执行 Agent 任务。它的职责 通过gRPC mTLS与后端安全连接身份由后端 PKI 证书背书 接收create_pod指令在本地生成隔离的 PTY Pod并运行 Agent 上报可用容量max_concurrent_pods参数参与调度 断线自动重连保证长时任务稳定典型上手三步详见 runner/README.md安装curl -fsSL https://agentsmesh.ai/install.sh | sh登录agentsmesh-runner login无头环境加--headless运行agentsmesh-runner run或agentsmesh-runner service install装成系统服务常驻⚙️ Runner 支持按需注册多台——想横向扩容 Agent 集群只需再装一台 RunnerPod 会在整个机群fleet中自动调度。Workspace每个 Pod 的 Git 隔离沙箱Workspace 是 Pod 的干净地盘Runner 为每个 Pod 创建独立的Git worktree 沙箱路径结构为sandboxes/{podKey}/workspace并配上专属凭证与独立分支。这带来三个新手最受益的保证互不踩踏10 个 Agent 并行改同一个仓库各自只在自己的 worktree 与分支里操作随时可恢复沙箱可重建Agent 跑崩了不影响主仓库代码可追溯Agent 产出按分支提交、推远程、自动关联 PR沙箱与 worktree 的实现入口在 runner/internal/workspace/ 与 runner/internal/runner/pod_builder_git.go。Ticket看板上的工作项连接需求与 AgentTicket 是 AgentsMesh 看板Kanban上的最小工作单位相当于一张任务卡片 填写标题、描述支持 Markdown、优先级、标签feature / bugfix / refactor 可直接绑定 Pod在 Ticket 上启动 Agent系统自动分配 Runner、创建 Pod 跟踪进度并关联 Agent 产出的MR/PR✅ PR 合并后Ticket 状态自动流转为已完成完整链路可参考官方用户故事 US-001-requirement-to-code-delivery.md创建 Ticket → 选择 Agent → 启动 Pod → 实时查看输出 → 提交 PR → Code Review → 合并四大概念如何协作一次完整交付把四个概念串起来就是一次典型的需求到代码流程步骤参与概念发生了什么1Ticket在看板创建需求卡片写明目标与验收点2AgentPod从 Ticket 启动 Pod选定 Agent如 Claude Code3Runner调度器挑一台在线 Runner本地拉起隔离 PTY 终端4WorkspaceRunner 建 worktree 沙箱 独立分支Agent 在其中编码5Ticket PodAgent 提交并推送Ticket 关联 PR合并后自动完成 进阶玩法多个 Pod 还能通过Channel绑定协作mention相互通信或由Autopilot控制 Agent 自动续命、无人值守长跑见 US-003-pod-delegation-and-orchestration.md。想在本地跑起来模块路径速查若想从源码跑起完整开发环境克隆仓库后一条命令启动PostgreSQL、Redis、MinIO、Backend、Relay、Traefik 前端热重载git clone https://gitcode.com/gh_mirrors/ag/AgentsMesh cd AgentsMesh/deploy/dev ./dev.sh新手建议按此顺序逛源码路径内容backend/Go API 服务端认证、Pod 生命周期、Ticket、计费relay/终端数据平面WebSocket 低延迟转发runner/自托管 Runner 守护进程与沙箱实现clients/web/Next.js Web 控制台终端 看板 拓扑图docs/userstory/四个官方用户故事最好的概念教材总结AgentPod 单个 Agent 的隔离执行环境终端 沙箱 实时输出Runner 装在自己机器上的守护进程真正干活的手Workspace 每 Pod 独享的 Git worktree 沙箱并行不冲突Ticket 看板工作项把需求、Pod 与 PR 串成闭环掌握这四个概念你就已经读懂了 AgentsMesh 的骨架——接下来装一个 Runner创建第一个 Pod 吧。【免费下载链接】AgentsMeshThe AI Agent Workforce Platform. Run a hundred AI coding agents across your own machines — schedule, isolate, and steer them all from one console.项目地址: https://gitcode.com/gh_mirrors/ag/AgentsMesh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考