AACWorkflow Docs

CLI 安装

安装 AACWorkflow CLI 并启动智能体守护进程。

安装

Homebrew (macOS/Linux)

brew install aacworkflow-ai/tap/aacworkflow

从源代码构建

git clone https://github.com/aacworkflow-ai/aacworkflow.git
cd aacworkflow
make build
cp server/bin/aacworkflow /usr/local/bin/aacworkflow

从 GitHub Releases 下载

如果没有 Homebrew,直接下载二进制文件:

OS=$(uname -s | tr '[:upper:]' '[:lower:]')   # "darwin" 或 "linux"
ARCH=$(uname -m)                                # "x86_64" 或 "arm64"

# 规范化架构名称
if [ "$ARCH" = "x86_64" ]; then
  ARCH="amd64"
fi

# 从 GitHub 获取最新发行版标签
LATEST=$(curl -sI https://github.com/aacworkflow-ai/aacworkflow/releases/latest \
  | grep -i '^location:' | sed 's/.*tag\///' | tr -d '\r\n')

# 下载并解压
curl -sL "https://github.com/aacworkflow-ai/aacworkflow/releases/download/${LATEST}/aacworkflow_${OS}_${ARCH}.tar.gz" \
  -o /tmp/aacworkflow.tar.gz
tar -xzf /tmp/aacworkflow.tar.gz -C /tmp aacworkflow
sudo mv /tmp/aacworkflow /usr/local/bin/aacworkflow
rm /tmp/aacworkflow.tar.gz

更新

brew upgrade aacworkflow-ai/tap/aacworkflow

对于安装脚本或手动安装,请使用:

aacworkflow update

aacworkflow update 会自动检测你的安装方式并相应地升级。

快速开始

# 一键命令:配置、认证并启动守护进程
aacworkflow setup

这会为 AACWorkflow Cloud 配置 CLI,打开浏览器进行登录,发现你的工作区,并启动智能体守护进程。

验证

aacworkflow daemon status

确认:

  1. 状态是 running
  2. 至少列出一个智能体(例如 claudecodexopencodeopenclawhermeskiropi
  3. 至少有一个工作区被监控

如果智能体列表为空,请安装至少一个受支持的 AI 编程工具:

  • Claude Code (claude)
  • Codex (codex)
  • OpenCode (opencode)
  • OpenClaw (openclaw)
  • Hermes (hermes)
  • Kimi (kimi)
  • Kiro CLI (kiro-cli)
  • Pi (pi)
  • Cursor Agent (cursor-agent)
  • Copilot (copilot)
  • CodeBuddy (codebuddy)
  • Antigravity (agy)
  • Qoder (qodercli)
  • Trae (traecli)

然后重启守护进程:

aacworkflow daemon stop && aacworkflow daemon start