Argonauts Code:以代码定义工作流的开源多智能体编排器
Open-source orchestrator for Claude Code, Codex, agy and OpenCode where the workflow is code, not a prompt (I'm the author)
Agent 开发者必看,提供了将多智能体工作流固化为代码的具体工程实践与测试方案,可直接参考其架构设计。
Disclosure up front: I'm the author. It's Apache-2.0 and free, with no hosted part and no pro tier.
提前声明:我是作者。该项目采用 Apache-2.0 协议,免费开源,无托管服务部分,也无专业版(pro tier)。
The problem I kept running into with multi-agent setups was that the process lived in a prompt. Plan, build, review, run the tests, merge: the agent did those when it remembered to. So in Argonauts Code the workflow is code. A workflow is a TOML file of steps (or a script), the built-in ones are written the same way, and the runner executes every step every time. Agents just fill the roles.
我在多智能体(multi-agent)设置中反复遇到的问题在于,流程逻辑存在于提示词(prompt)中。规划、构建、审查、运行测试、合并:智能体仅在它“记得”时才执行这些操作。因此在 Argonauts Code 中,工作流即代码。工作流是一个由步骤组成的 TOML 文件(或脚本),内置步骤以相同方式编写,且运行器每次都会执行所有步骤。智能体仅承担角色填充功能。
How it's put together:
其组成方式如下:
- Each CLI is driven through its headless structured output, not by scraping a terminal: claude -p --output-format stream-json, codex exec --json, opencode run --format json. ACP agents and a small manifest cover other CLIs.
- Builders work in separate git worktrees. Checks run on each task and again on the exact commit you'd merge.
- If you don't name reviewers, review goes to a different provider than the builder where the crew has one.
- In the Council workflow, seats answer without knowing which model the others run, then talk it out until they agree on a plan.
- Local models write code through OpenCode. For reviews, judging and summaries, local servers (Ollama, LM Studio, llama-server, vLLM) are found automatically, and any other OpenAI-compatible server takes a few lines of config.
- Headless use: argonauts run --crew --plain --limit-usd 2 "...", an append-only log of every step, argonauts run-review to compare a run's predictions with what happened, and argonauts mcp serve.
- 每个 CLI 均通过其无头结构化输出来驱动,而非通过抓取终端界面:claude -p --output-format stream-json、codex exec --json、opencode run --format json。ACP 智能体和小型清单(manifest)覆盖其他 CLI。
- 构建者在独立的 git worktree 中工作。检查会在每个任务上运行,并在你准备合并的确切提交上再次运行。
- 如果你未指定审查者,当团队中有一个审查者时,审查会交由另一个提供商处理。
- 在 Council 工作流中,席位上的智能体在不知道其他智能体使用何种模型的情况下进行回答,然后通过讨论达成一致的计划。
- 本地模型通过 OpenCode 编写代码。对于审查、评判和摘要,会自动发现本地服务器(Ollama、LM Studio、llama-server、vLLM),任何其他兼容 OpenAI 的服务器只需几行配置即可接入。
- 无头模式用法:argonauts run --crew --plain --limit-usd 2 "...",每一步都有追加式日志记录;argonauts run-review 用于比较某次运行的预测与实际结果;以及 argonauts mcp serve。
Testing is where I spent the most thought. None of the 10k+ tests call a model. Each CLI's output is recorded once against a specific CLI version and replayed, and fake CLIs play scripted scenarios for everything else. When a CLI updates, a rerecord script makes a few live calls on its cheapest model and reports which recordings changed shape.
测试是我投入最多思考的地方。超过 10,000 个测试均未调用模型。每个 CLI 的输出针对特定 CLI 版本记录一次并回放,其他情况则由模拟 CLI 播放预设场景。当 CLI 更新时,重新录制脚本会在其最便宜的模型上进行少量实时调用,并报告哪些录制的输出形状发生了变化。
On rule 7: most of the code was written by Claude Code agents running in parallel lanes, with separate reviewer agents. I designed it, approved each screen as a text drawing before it was built, and decided what merged. Every change goes through a PR with CI (clippy with warnings as errors, cargo deny, the full test suite).
关于第 7 条规则:大部分代码由并行通道中运行的 Claude Code 智能体编写,配有独立的审查者智能体。我负责设计,在构建之前批准了每个屏幕作为文本绘图的内容,并决定哪些内容被合并。每项更改都通过带有 CI 的 PR 进行(clippy 将警告视为错误、cargo deny、完整测试套件)。
What I don't have yet is a real measurement of whether cross-provider review catches more real bugs than it adds noise. A fair test needs a lot of tasks, repeats and a single-agent baseline, and I haven't run one. If you've done something like that, I'd like to hear how you set it up.
我目前尚未拥有的是对跨提供商审查是否能比引入噪声捕获更多真实 bug 的实际测量数据。一个公平的测试需要大量任务、重复实验以及单智能体基线,而我尚未运行此类测试。如果你做过类似的事情,我很想听听你是如何设置的。
It's alpha, macOS and Linux only. The video is a scripted tour on sample data, and its run window, galaxy-style Behaviors view and the mascot arriving at session start come in the next version.
目前为 Alpha 版本,仅支持 macOS 和 Linux。视频是基于示例数据的脚本化演示,其运行窗口、类 Galaxy 的 Behaviors 视图以及会话启动时的吉祥物将在下一个版本中推出。
Repo: https://github.com/sheng-tse/argonauts-code
仓库:https://github.com/sheng-tse/argonauts-code
The built-in workflow files, if you want to see the format: https://github.com/sheng-tse/argonauts-code/tree/main/crates/core/templates/workflows
内置的工作流文件(如果你想查看格式):https://github.com/sheng-tse/argonauts-code/tree/main/crates/core/templates/workflows
更进一步:量化金融体系
看懂新闻只是起点——沿量化金融路径,把它变成能交付的工程能力