README
¶
conduct
A command-line tool that interprets workflow definitions (JSON) into deterministic steps and drives multiple AI coding engines (claude-code / antigravity / qoder / codex) through them, step by step.
Install
macOS / Linux — install the latest release with one line:
curl -sSL https://raw.githubusercontent.com/qoggy/conduct/main/install.sh | sh
Or, with a Go toolchain, install from source:
go install github.com/qoggy/conduct/cmd/conduct@latest
Update
Once installed, conduct updates itself in place:
conduct update # update to the latest release
conduct update --check # check for a newer version without installing
conduct update v0.2.0 # install a specific version (a version tag opts into pre-releases)
Uninstall
conduct is a single binary. Remove it, and optionally its data:
rm "$(command -v conduct)" # prefix with sudo if it lives in a system dir like /usr/local/bin
rm -rf ~/.conduct # optional: workflows and run records
Usage
conduct --help
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
conduct
command
Command conduct 是多引擎 AI workflow 编排 CLI 的可执行入口。
|
Command conduct 是多引擎 AI workflow 编排 CLI 的可执行入口。 |
|
internal
|
|
|
cli
Package cli 组装 conduct 的命令行界面（基于 Cobra）。
|
Package cli 组装 conduct 的命令行界面（基于 Cobra）。 |
|
engine
Package engine 定义 AI 编程引擎的无头执行抽象，以及引擎注册表。
|
Package engine 定义 AI 编程引擎的无头执行抽象，以及引擎注册表。 |
|
help
Package help 承载 conduct 的长文档主题——教程 / 概念 / 最佳实践这类跨命令的深度内容。
|
Package help 承载 conduct 的长文档主题——教程 / 概念 / 最佳实践这类跨命令的深度内容。 |
|
launch
Package launch 是 CLI 与 UI 共用的「后台发射器」：以独立会话（setsid）self-exec 出一个 `conduct workflow run <name> --cwd <dir>` 前台子进程、经 stdin 喂入用户需求，再有界等待子进程 落下初始 run.json，把可用 run id 交回调用方。
|
Package launch 是 CLI 与 UI 共用的「后台发射器」：以独立会话（setsid）self-exec 出一个 `conduct workflow run <name> --cwd <dir>` 前台子进程、经 stdin 喂入用户需求，再有界等待子进程 落下初始 run.json，把可用 run id 交回调用方。 |
|
orchestrator
Package orchestrator 是 conduct 的解释器内核：把一份 workflow 定义展开成确定性步骤， 逐步驱动 AI 引擎执行，串联上游产物与评测反馈，并把运行记录落盘。
|
Package orchestrator 是 conduct 的解释器内核：把一份 workflow 定义展开成确定性步骤， 逐步驱动 AI 引擎执行，串联上游产物与评测反馈，并把运行记录落盘。 |
|
run
Package run 定义运行记录实体：一次 workflow 执行的不可变历史。
|
Package run 定义运行记录实体：一次 workflow 执行的不可变历史。 |
|
store
Package store 是 ~/.conduct 下的托管工作流 store：纯文件、按名寻址，无数据库。
|
Package store 是 ~/.conduct 下的托管工作流 store：纯文件、按名寻址，无数据库。 |
|
ui
Package ui 是 conduct 的可视化界面服务端：一个只绑 127.0.0.1 的本地 HTTP 服务，把 CLI 动词 镜像成人看的视图（工作流列表 / 编辑器 / 运行列表 / 运行详情）。
|
Package ui 是 conduct 的可视化界面服务端：一个只绑 127.0.0.1 的本地 HTTP 服务，把 CLI 动词 镜像成人看的视图（工作流列表 / 编辑器 / 运行列表 / 运行详情）。 |
|
workflow
Package workflow 承载 workflow 定义的数据模型、落盘校验与展开算法。
|
Package workflow 承载 workflow 定义的数据模型、落盘校验与展开算法。 |
Click to show internal directories.
Click to hide internal directories.