Kombinat

把仓库里的 Markdown 文件变成定时或 Webhook 触发的 AI 例行任务,跑在你自己的机器和已有订阅上。

Star 数
★ 17
最近更新
今天
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具自托管服务网页应用
可在哪里用
通用 · 跨平台Codex · Claude CodeOpenAI API · Claude API(部分支持)
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node 24Claude Code CLI(已登录)或 Codex CLI(已登录)macOS(launchd)或 Linux(systemd 用户服务)Shell / 命令行网络访问本地文件系统
典型场景
个人开发者把 Mac mini 或 Linux 小主机当作常驻机器,夜间自动处理带 agent 标签的 issue 并提交 PR。
不适合
  • 没有长期开机 Mac/Linux 机器、只靠笔记本合盖运行的团队
  • 需要浏览器登录鉴权或公网多租户访问控制的使用场景
  • 不允许 Agent 在无人值守下操作本地文件与登录态的组织
官网
kombinat.tech ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-20最新版本 v0.8.0(2026-11-20)

这个 Agent 能做什么,适合哪些场景?

Kombinat 是一个开源的本地调度守护进程,把 routines/ 目录下的每个 Markdown 文件当作一条「例行任务」:文件 frontmatter 定义 cron 计划、工作目录、所用 agent、模型、超时等参数,正文就是给 agent 的提示词。守护进程每 30 秒检查一次哪些任务到期,然后调用 claude -p、codex exec 或任意自定义 CLI 命令执行,并在 http://localhost:7433 提供网页仪表盘,另有 pnpm kombinat tui 终端界面。macOS 上由 launchd、Linux 上由 systemd 用户服务保证守护进程常驻与开机自启,运行日志和记录保存在 ~/.kombinat/。合并即上线:守护进程每 5 分钟在 main 分支执行 git pull,锁文件变化时自动安装依赖并重启,无需手动部署。它依赖你已付费的 Claude Code 或 Codex 订阅登录,运行时会剥离 API key 环境变量。

读取 routines/ 下 Markdown 文件的 YAML frontmatter(name、description、schedule、cwd、agent、model、fallbackModel、effort、timeoutMinutes、permissionMode、maxBudgetUsd、before/after、enabled、webhook),把正文作为提示词。守护进程按 KOMBINAT_TICK_SECONDS(默认 30 秒)扫描到期任务,最多并发 3 个(KOMBINAT_MAX_CONCURRENT),同一任务不会重叠运行,超时默认 55 分钟后终止;机器休眠后最多补跑最近 7 天内错过的一次。执行时调用 claude -p 或 codex exec,或执行 command 指定的任意 CLI(提示词经 stdin 传入,输出即结果);before 钩子在运行前执行 shell 命令,after 钩子在结束后无论成败执行一次并通过 stdin 接收运行结果。设置 webhook: true 的任务可被 Linear、GitHub 等应用以 HTTP 请求触发,请求体注入提示词,可选 webhookGate 命令校验与过滤,运行中到达的请求进入队列。所有运行的完整 transcript 可在网页仪表盘、TUI 和手机上查看,并可继续对话;pnpm kombinat readme 会根据 routines 目录自动更新 README 中的任务表格。

  1. 个人开发者把 Mac mini 或 Linux 小主机当作常驻机器,夜间自动处理带 agent 标签的 issue 并提交 PR。
  2. 团队希望例行任务像代码一样走 review:在分支里新增一个 Markdown 文件,合并后 5 分钟内自动生效。
  3. 需要让 Claude Code 或 Codex 在已有登录态、skills、MCP server 和浏览器控制的环境中运行,而不是在 CI 容器里重建环境。
  4. 用 Linear 或 GitHub 的 webhook 触发 on-call 检查、发布后回归监控等事件驱动任务。
  5. 在个人 Mac 上安排生活类例行任务,例如查天气、找折扣、监控网页变化并记录在案。
  6. 不愿意自己写 cron + claude -p + 日志 + 仪表盘的一整套胶水代码,想要开箱即用的本地调度方案。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npx kombinat init my-routines
  • npx kombinat serve
  • pnpm add kombinat
  • npx kombinat connect admin@mac-mini # 浏览器中打开仪表盘
环境变量
KOMBINAT_PORT KOMBINAT_STATE_DIR KOMBINAT_ROUTINES_DIR
配置文件
~/.kombinat
运行环境
Node.js 24
安装说明涉及
macOS

如何安装或部署这个 Agent?

需要 Node 24,并已登录 Claude Code(claude auth status)或 Codex(codex login)。在新建目录中初始化示例任务:

npx kombinat init my-routines

在已有仓库中,于仓库根目录执行 npx kombinat init(pnpm 项目用 pnpm dlx kombinat init),它不会覆盖已有文件。随后启动:

cd my-routines
npx kombinat serve

安装为后台守护进程(launchd / systemd 用户服务):

pnpm add kombinat
pnpm kombinat install

在另一个目录再次执行 install 会把唯一的守护进程迁移过去。

如何使用这个 Agent?

在 routines/ 中新建一个 Markdown 文件,frontmatter 定义计划与参数,正文写提示词,例如:

---
name: fix-e2e-tests
description: Finds the failing e2e test and fixes it
schedule: '30 11 * * *'
cwd: ~/projects/app
agent: claude
model: claude-opus-5-5
fallbackModel: claude-sonnet-5-5
effort: high
timeoutMinutes: 55
---

1. Open the latest failed e2e run on GitHub ...

保存后无需重启,下一次检查即生效。常用命令(在装 kombinat 的目录执行;npm 用 npx kombinat,Yarn 用 yarn kombinat):

pnpm kombinat list           # 任务列表、下次运行时间、上次状态
pnpm kombinat run <name>     # 立即在前台运行某个任务
pnpm kombinat validate       # 校验所有任务文件
pnpm kombinat tui            # 终端仪表盘,可经 ssh 使用
pnpm kombinat status         # 守护进程与调度状态
pnpm kombinat readme         # 更新 README 中的任务表格
pnpm kombinat uninstall      # 停止并移除守护进程

远程访问可经 SSH 隧道或 Tailscale Serve:

npx kombinat connect admin@mac-mini         # 浏览器中打开仪表盘
npx kombinat connect admin@mac-mini --tui   # 终端中打开仪表盘
tailscale serve --bg 7433                   # 在 tailnet 内开放仪表盘

环境变量(在 install 前设置,会写入 launchd/systemd 配置):KOMBINAT_PORT(默认 7433)、KOMBINAT_STATE_DIR(默认 ~/.kombinat)、KOMBINAT_ROUTINES_DIR(默认 ./routines)、KOMBINAT_MAX_CONCURRENT(默认 3)、KOMBINAT_TICK_SECONDS(默认 30)、KOMBINAT_PULL_MINUTES(默认 5,0 关闭)、KOMBINAT_PULL_BRANCH(默认 main)、KOMBINAT_KEEP_AWAKE、CLAUDE_BIN、CODEX_BIN。

这个 Agent 有哪些优点和局限?

优点
  • 任务即 Markdown 文件,随代码走 review 与 git 历史,合并后由守护进程自动 git pull 上线。
  • 直接复用本机已有的 Claude Code / Codex 登录态、CLAUDE.md、skills 与 MCP server,不额外付 API 账单。
  • 内置运行记录、transcript、超时、并发上限、防重叠、休眠补跑、webhook 与网页/TUI 双界面,省去自己写 cron 胶水。
  • 支持 claude、codex 和任意 command CLI,可在 macOS launchd 与 Linux systemd 上自托管,无云服务、无数据库,仅两个依赖。
  • 可在本地审查的配置粒度:每个任务单独设定 permissionMode、maxBudgetUsd、模型回退链与前后钩子。
局限
  • 需要一台长期开机并保持登录的 Mac 或 Linux 机器;笔记本合盖或休眠时任务不会运行(macOS 上仅接电源时保持唤醒)。
  • 仪表盘只监听 localhost 且没有登录,同机用户即可访问;经 Tailscale Serve 暴露后,能访问该端口的人可以用任务的 agent、目录与权限执行任意提示词。
  • 必须自行准备并登录 Claude Code 或 Codex 订阅;文档提示团队共享同一订阅登录前需先确认服务条款。
  • 守护进程每 5 分钟自动 git pull 并可能安装依赖,配置不当会带来供应链与误合并风险,需对 main 分支加分支保护。
  • 任务失败或提问无人应答,提示词写不严谨就会空转;只能通过任务文本约定「No / Nothing」让 Inbox 归类。

这个 Agent 与同类方案有什么区别?

README 明确对比了四种替代方式:手动运行 Claude Code(工作不会按时发生)、Claude Code 自带的 Routines(不存于 git、不走 review、不能换 Codex 等其他 CLI agent)、直接写 cron 调 claude -p(缺少运行历史、transcript、超时、防重叠、休眠补跑、仪表盘和 webhook)、以及定时 CI 工作流(agent 不在你已有登录态、skills 和 MCP server 的机器上运行)。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Kombinat 当前 54 · 缺口较多 命令行工具免费 + 模型费 ★ 17 今天 TypeScript Codex · Claude Code
kwant 68 · 存在缺口 — ★ 681 1 天前 Rust Codex · Claude Code · OpenAI API · Claude API
HermesClaw 52 · 缺口较多 自托管服务免费 + 模型费 ★ 765 1 个月前 Python —
Brigade——企业级个人智能体 62 · 存在缺口 命令行工具免费 + 模型费 ★ 11k 8 天前 TypeScript ChatGPT · Codex · Claude Code · OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
54/ 100 五分制 2.7 / 5
本评测基于 2026年11月18日 的源码;此后该项目发布了 2 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 12/29
可靠稳定 6/14
适用触发 14/18
规范维护 10/18
有效结果 9/13
证据核验 3/8
查看各维度的扣分理由
信任安全12 / 29 · 2.1/5

README 明确说明默认权限模式(Claude 默认拒绝需批准操作、Codex 默认 workspace-write)、API key 变量被移除、无遥测、仪表盘仅监听 localhost,这些是加分项;但仪表盘无登录且同机用户可任意发提示词、bypassPermissions/danger-full-access 可放开一切、守护进程每 5 分钟自动 git pull 并安装依赖、webhook 输入可被注入,均属高风险默认行为且缺少确认环节,故 least_privilege 仅 2、user_confirmation 仅 1、sensitive_data_handling 仅 1。依赖安全方面仅见 CI 对打包产物的 import 白名单检查,未见依赖审计或漏洞策略,给 1。回滚仅提到 uninstall 与运行记录保留,无版本回退或状态恢复机制,给 1。来源归属仅 LICENSE 与作者署名,发布者身份未经验证,给 1。

可靠稳定6 / 14 · 2.1/5

README 与 AGENTS.md 对架构、命令、调度语义(不重叠、最多 3 并发、补跑 7 天)描述一致,self_consistency 给 2;但依赖 Node 24、pnpm 11、外部 CLI agent 与订阅登录,可用性依赖较多且未给出降级路径,dependency_availability 给 1;失败信息仅在 TUI 代码中见 crash 处理与 validate 命令,缺少面向用户的错误分类说明,failure_messages 给 1。

适用触发14 / 18 · 3.9/5

README 覆盖定时、webhook、手动、Mac/Linux、SSH/Tailscale、家庭与工作场景,audience_and_scenarios 给 3;能力边界(agent 类型、权限模式、超时、预算上限、并发上限)有表格说明,但 command 模式可任意执行、边界描述仍偏薄,给 2;触发精度有 cron 五段式、manual、webhook 与 webhookGate,但未见时区/DST 细节,给 2;环境适配有 launchd/systemd、linger、keep-awake 说明,但仅限 Mac/Linux,给 2。

规范维护10 / 18 · 2.8/5

README 结构清晰、安装步骤完整(init/serve/install、pnpm/npm/yarn 变体),information_architecture 与 install_notes 各给 2;包名从 @danilqa/kombinat 迁移到 kombinat 且旧 launchd 任务会失效,naming_stability 给 1;示例 routine 与对比表充分,examples_and_faq 给 2;已知限制(睡眠、单用户守护进程、订阅条款、仪表盘无鉴权)有明确说明,给 2;LICENSE 为完整 MIT 文本,给 3;版本更新仅靠仪表盘卡片与 changelog 链接,仓库内无 CHANGELOG 文件,versioning_changelog 给 1;维护责任仅见作者署名与 CI,无治理或支持承诺,且发布者未验证,给 1。

有效结果9 / 13 · 3.5/5

输出可用性有仪表盘、TUI、运行记录、Inbox 分类与 readme 生成,output_usability 给 2;相对 cron+claude -p 的边际价值(运行历史、超时、去重、webhook、审查流程)有具体对比,给 2;成本方面强调复用已有订阅、无 API 账单、两个依赖,但需常开机器与订阅条款风险,cost_benefit 给 2。

证据核验3 / 8 · 1.9/5

README 的多数主张可对应到 AGENTS.md、CI 工作流与源码片段(如 TUI 轮询、e2e fixture、打包检查),但缺少逐条引用与可复现证据,claim_traceability 给 1;跨源印证仅覆盖部分主张(CI 与 AGENTS.md 一致),核心安全与调度行为无源码佐证,cross_source_corroboration 给 1;文档中事实与营销表述(如“5 分钟内生效”“无 API 账单”)混排,未区分推断与事实,fact_inference_separation 给 1。

风险与缓解建议
  • 仪表盘无登录且仅靠 localhost 隔离,同机其他用户可读取运行记录并以任意提示词驱动 agent;远程暴露需自行用 SSH/Tailscale ACL 限制。
  • 守护进程每 5 分钟自动 git pull 并在锁文件变化时安装依赖,main 分支被污染即可导致任意代码执行,必须启用分支保护与审查。
  • bypassPermissions 与 danger-full-access 会让 agent 拥有当前用户全部权限;处理外部文本(issue、webhook)的 routine 存在提示词注入风险。
  • 发布者身份未经验证,包名迁移(@danilqa/kombinat → kombinat)会破坏旧 launchd 任务,升级前需确认来源与迁移步骤。
  • 依赖 Node 24、pnpm 11 与外部 CLI agent 及订阅登录,环境不满足时无降级路径;本次为静态审查,未执行任何代码或测试。
证据充分度:低 评估于 2026年11月18日 审查版本 00a2ab4296bd 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/kombinat.svg?lang=zh)](https://followagents.com/zh/agents/kombinat)
<a href="https://followagents.com/zh/agents/kombinat"><img src="https://followagents.com/badge/kombinat.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.8.0
    发布说明摘录
    - Run a routine once later from the Run now menu: in 1 hour, tonight, tomorrow, next Monday, in a week or at a time you pick. The routine page lists these runs with Cancel, and the Calendar and the terminal dashboard show them too (#127) - A Claude run that hits the 5-hour or weekly limit now waits for the reset and continues the same session, with Continue now and Stop waiting on its page. Set onUsageLimit: fail to keep the old behaviour (#119) …
    在 GitHub 查看 ↗
  2. v0.7.0
    发布说明摘录
    - An Inbox lists the runs that ended since you last looked, grouped into Needs a look, Has findings and Nothing to report. The daemon keeps what you have read, so every device and the terminal dashboard agree (#101) - The header shows how much of your Claude plan is left, taken from the runs' own output with no login (#100) - The dashboard and the terminal dashboard update the moment a run starts or ends, and running times count up live (#92, #104) - Search inside a run's transcript (#102, #116) …
    在 GitHub 查看 ↗
  3. v0.6.0
    发布说明摘录
    - Chat with a run's agent from its run page. A message resumes the run's session, and the scheduler, Run now and webhooks wait while it replies (#88) - Webhooks of one conversation, such as the messages of a Linear agent session, continue the same run: the webhookGate exits with 79 and prints the conversation's key and the message (#98) - Run now has a "Change prompt and run" option that runs once with an edited prompt and leaves the routine file untouched (#90) …
    在 GitHub 查看 ↗

常见问题

运行任务需要额外付 API 费用吗?
不需要。claude 与 codex 任务使用你已付费的订阅登录,Kombinat 会在其环境中移除 API key 变量;软件本身是 MIT 开源、免费的。可选 maxBudgetUsd 只对 claude 生效,用于给单次运行设预算上限。
计划任务错过时间会怎样?
如果机器休眠或守护进程未运行,每个任务会为最近一次错过的时间补跑一次,最多回溯 7 天;同一任务不会重叠执行,如果到下一次触发时仍在运行则跳过该次。最多 3 个任务并发。
把仪表盘暴露到其他设备安全吗?
默认只监听 localhost 且没有登录。通过 SSH 隧道(npx kombinat connect)或 Tailscale Serve 访问时,能触达该端口的人都可以读取 transcript、启动任务、向 agent 发消息,甚至用该任务的 agent、目录和权限执行任意提示词,应通过 Tailscale 访问规则限制可达人群。
能接哪些触发方式和 agent?
触发方式包括 5 段 cron(本地时间)、manual 手动,以及 webhook: true 配合 Linear、GitHub 等任意应用的 HTTP 请求(可加 webhookGate 做校验过滤)。agent 可选 claude(claude -p)、codex(codex exec)或 command(任意 CLI,提示词经 stdin 传入)。
新增或修改任务要重启守护进程吗?
不需要。文件改动在下一次检查(默认 30 秒)时生效;合并到 main 后由守护进程每 5 分钟 git pull 自动拉取,锁文件变化时安装依赖并重启,正在运行的任务不会被打断。
Kombinat 官网是什么?
Kombinat 的 GitHub 仓库填写的官网是 https://kombinat.tech。这个链接由仓库作者设置;源码在 GitHub(Danilqa/kombinat)。
Kombinat 开源吗?
开源。源码在 GitHub(Danilqa/kombinat),许可证是 MIT。
Kombinat 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。最新版本是 v0.8.0(2026-11-20)。
Kombinat 是谁开发的?
Kombinat 由 GitHub 账号 Danilqa 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念