Podiom是一个Go守护进程,通过编排现有Claude与Codex CLI,为多个Agent提供共享账本、工作区和长期项目上下文。它不替代Agent及其工具体系,而是解决跨会话状态、长期目标和协作知识分散问题。
Claude Code 和 Codex 都是非常出色的工具,但从根本上说,它们都是以会话为中心的。
如果只是回答问题或进行目标明确的代码修改,这种模式非常合适。但当你开始把 Agent 当作真实项目中的协作者时,就会逐渐感觉少了些什么。
项目本身并不真正存在。
多个 Agent 之间没有可以共同继承和积累的共识。长期目标没有负责人。定时任务最终散落在 cron job 和 shell 脚本里。没过多久,你就会积攒下一堆 Markdown 笔记、辅助脚本和约定,而且只有你自己知道它们是什么意思。
我想要一种不同的东西。
不是另一个 coding agent,也不是另一个模型 API。
而是一个位于我已经在使用的 Agent 之上的项目层。
Podiom 是一个用 Go 编写的 daemon,用于编排你已经安装好的 claude 和 codex CLI。
它不会取代 Claude Code 或 Codex,也不会重新实现它们的工具、MCP server 或 skill。相反,它提供的是围绕这些 Agent 构建的共享项目状态。
共享项目上下文。每个项目都有一份共享 ledger 和 workspace,所有已配置的 Agent 都可以读取和更新,因此知识不会被困在单独的对话中。
目标。描述预期结果、定义成功标准、分配 Agent,然后让它规划工作、检查进度,并随着时间推移持续汇报。
调度。周期性工作只是一份带有 YAML frontmatter 的 Markdown 文件。把它放进一个文件夹,选定的 Agent 就会利用项目的共享上下文自动执行。
会话连续性。即使你切换 provider 或 profile,Agent 也可以接着之前的工作继续,而不必每次都从头开始。
Podiom 以单个静态 Go 二进制文件的形式发布,其中嵌入了 Svelte UI,并使用纯 Go 实现的 SQLite(modernc.org/sqlite),因此可以轻松地为 Linux、macOS 和 Windows 的 amd64 与 arm64 架构进行交叉编译。
其中一项设计目标,是避免隐藏配置。
定时任务就是 ~/.podiom/schedules/ 目录下的一份 Markdown 文件。YAML frontmatter 定义任务何时运行,正文则是 prompt。
---
agent: jared
model: ""
effort: low
cron: "0 7 * * *"
run_permission: preapproved
allowed_tools: []
enabled: true
goal_id: ""
---
Summarise today's calendar and add a short note to the "daily-briefs"
project. Keep it to three lines.
不需要维护单独的调度器配置。只要把文件放进该目录,Podiom 就会自动发现它。
由于这些任务经常在无人值守的情况下运行,因此默认执行模式被有意设计得比较保守。使用 run_permission: preapproved 时,只有明确允许的工具才能执行具有副作用的操作。其他所有操作都会被拒绝,而不是在凌晨 3 点静静等待某个人批准 prompt。
你也可以通过 CLI 管理定时任务:
podiom schedules list
podiom schedules run morning-calendar
每次定时运行都会成为一个普通的 Podiom session,因此你可以轻松检查发生了什么,或者之后通过交互方式继续完成相关工作。
调度解决的是:“每天早上运行这个任务。”
目标解决的则是:“继续朝这个结果推进,直到它真正完成。”
创建目标时,你需要定义:
负责该目标的 Agent
此后,被分配的 Agent 会创建自己的计划,把工作拆分成任务或定时任务,定期检查进度,并持续记录更新。
当它认为成功标准已经满足时,就会提议完成目标。
只有你能够真正将目标标记为已完成。
整个生命周期被有意设计得非常简单:
Agent 的权限止于提出建议。
podiomd 是 daemon。它承载 Web UI、调度器、项目逻辑和 session 编排,并由 SQLite 提供数据支持。
podiom 是一个轻量级 CLI 客户端,用于与 daemon 通信。
前端使用 Svelte、Vite、TypeScript 和 Tailwind 构建,并在构建过程中直接嵌入 Go 二进制文件。
所有内容都存放在一个可配置的根目录下($PODIOM_HOME,默认为 ~/.podiom/)。
此外还有一个 Home Assistant add-on,可以方便地将 Podiom 暴露到本地网络之外,同时依赖 Home Assistant 的身份验证与安全机制,而不是直接暴露 daemon。
Podiom 不是另一个模型 provider。
它构建在 Claude Code 和 Codex CLI 之上,因此你需要提前安装并认证其中一个或两个。
它目前仍处于早期阶段(v0.4.x),有意采用单用户设计,也没有试图成为一个托管式多租户平台。
curl -fsSL https://github.com/Podiom/Podiom/releases/latest/download/install.sh | bash
安装程序会运行 podiom onboard,检查 Claude Code 和 Codex,并引导你创建第一个 Agent。
你也可以自行构建(Go 1.26+、Node 20+):
make build
./bin/podiomd
./bin/podiom status
该项目采用 MIT 许可证。
代码仓库、文档和环境要求:https://github.com/Podiom/Podiom
欢迎提供反馈、想法、issue 和 pull request。
如需采取进一步行动,你可以考虑屏蔽此人和/或举报滥用行为。