counselors

由 Aaron Francis 开发，他也是 Faster.dev 和 Solo 的创建者。

将提示词（prompt）并行分发给多个 AI 编码智能体（Agent）。

counselors 可以同时将相同的提示词发送给 Claude、Codex、Gemini、Amp 或自定义工具，收集它们的响应，并将所有内容写入结构化的输出目录。

它不依赖 MCP 服务器，无需直接的 API 集成，也没有复杂的配置。它仅仅是调用你本地安装的 CLI 工具。

这会导致我的账号被封禁吗？

Counselors 仅使用提供商的第一方 CLI 工具。它不会直接调用提供商的 API，不会提取或重用身份验证令牌（auth tokens），也不会在后台执行任何“投机取巧”的操作。它实际上运行的就是你已经在终端安装的官方 CLI 二进制文件，和你手动执行的方式完全一致。

你仍然受制于每个提供商的服务条款和速率限制。Counselors 只是这些 CLI 的一个协调器。

智能体（Agentic）快速入门

首先自行安装 CLI（任选一种）：

• npm (要求 Node 20+): npm install -g counselors
• Homebrew: brew install aarondfrancis/homebrew-tap/counselors
• 独立二进制文件: curl -fsSL https://github.com/aarondfrancis/counselors/raw/main/install.sh | bash

然后将以下内容粘贴到你的 AI 编码智能体中：

Run `counselors init --auto` to discover and configure installed AI CLIs. Then run `counselors skill` to see how to create a skill for the counselors CLI.

你的智能体将会配置可用的工具并设置 /counselors 斜杠命令。

更新你的 Skill

推荐的 skill 模板会随着时间更新。如果你已经在你的智能体系统中安装了 /counselors，请不要盲目覆盖它。

将以下内容粘贴到你的 AI 编码智能体中：

The counselors CLI has an updated skill template.

1. Run `counselors skill` and capture the full output.
2. Open my existing counselors skill file and compare VERY CAREFULLY for anything that changed.
3. Apply the updates manually; do not blindly overwrite.
4. If you need more context, check the git history for the skill template here:
   https://github.com/aarondfrancis/counselors/commits/main/src/commands/skill.ts

工作原理：

1. 你使用提示词调用 Counselors skill。
2. 你的智能体从代码库中收集上下文。
3. 你的智能体询问你想要咨询哪些其他智能体。
4. Counselors 并行分发给这些智能体进行独立研究。
5. 每个智能体都会编写一份结构化的 Markdown 报告。
6. 你的主智能体汇总并呈现结果。

示例： 在完成大型重构后，向你的智能体寻求第二意见：

/counselors We just completed a major refactor of the authentication module.
Review the changes for edge cases, test gaps, or regressions we might have missed.

你的主智能体负责处理剩余工作——它会收集相关代码、最近的提交记录，并在分发给 counselors 之前组装一份详细的提示词。

人工操作快速入门

安装 CLI（任选一种）：

• npm (要求 Node 20+): npm install -g counselors
• Homebrew: brew install aarondfrancis/homebrew-tap/counselors
• 独立二进制文件: curl -fsSL https://github.com/aarondfrancis/counselors/raw/main/install.sh | bash

# 发现已安装的 AI CLI 并创建配置
counselors init

# 将提示词发送给所有配置的工具
counselors run "Trace the state management flow in the dashboard and flag any brittleness or stale state bugs"

# 仅发送给特定的工具
counselors run -t claude,codex "Review src/api/ for security issues and missing edge cases"

支持的工具

工具	适配器	只读模式	安装
Claude Code	claude	已强制执行	docs
OpenAI Codex	codex	已强制执行	github
Gemini CLI	gemini	已强制执行	github
Amp CLI	amp	已强制执行	ampcode.com
自定义	用户定义	可配置	—

命令

run [prompt]

将提示词并行分发给已配置的工具。

counselors run "Your prompt here"
counselors run -f prompt.md              # 使用提示词文件
echo "prompt" | counselors run           # 从标准输入读取
counselors run --dry-run "Show plan"     # 预览而不执行
counselors run -t opus,opus,opus "Review this"  # 多次运行同一工具

标志 (Flag)	描述
-f, --file	使用提示词文件（不进行包装）
-t, --tools	以逗号分隔的工具 ID
-g, --group	以逗号分隔的组名（展开为工具 ID）
--context	从路径收集上下文（逗号分隔，或用 . 代表 git diff）
--read-only	strict（严格）、best-effort（尽力而为）、off（关闭）（默认为配置中的 readOnly）
--dry-run	显示将要执行的操作而不实际运行
--json	以 JSON 格式输出清单
-o, --output-dir	基础输出目录