代理人

一个人物来统治他们.
多LLM开发实用标准层.

快速启动 • 妇女 一体化 • 妇女 图标 • 妇女 插件 • 妇女 财务问题

问题

指令趋同于 AGENTS.md 和技能凝聚在一起 SKILL.md. MCP 服务器配置没有. 每个工具都保存自己的文件,以自己的格式保存在自己的位置:

用手加一个服务器,你写了18次,然后看复制件散去.

agents 保持一个真相的来源 .agents/ 并实现它 对于每一个工具你启用.

快速启动

# 1. Install
npm install -g @agents-dev/cli

# 2. Interactive setup — picks integrations, adds MCP servers, syncs everything
agents start

# 3. Re-sync whenever config changes
agents sync

.agents/agents.json 现在,是真理的唯一来源. agents sync --check 输出 2 当一个工具配置被漂移时,它就起到CI门的作用.

支持的整合

出十八种工具来. "验证"指工具自己的CLI被运行于此项目所写的文件中;其余则遵循供应商文件,如果某事被关闭则值得报告.

技能专栏. bridge 表示工具目录中的同义链接 .agents/skills (无符号链接的复制品). native 表示工具读取 .agents/skills 自己,所以没有创造. — 表示工具的项目级技能定位在此没有被执行.

Grok 文件夹信任 . Grok忽略了一个项目的MCP服务器及其技能 grok inspect 仅列出无。 信赖生活 ~/.grok/trusted_folders.toml,从 config.toml。 。 。 . agents doctor 报告一个不信任的文件夹和 agents doctor --fix 记录信任.

共享文件 . .mcp.json 由克劳德代码和副驾驶CLI读取,所以 agents 都写过一次 仅针对其中一款的服务器仍然可见于另一款;同步表示而不是假装目标将其隔离.

鹅的秘密. Goose从环境中读取证书 env_keys,所以从不将值写入其配置中。 您的外壳中必须存在的变量同步列表 .

项目布局

your-project/
├── AGENTS.md                        ← Canonical instructions for all tools
├── CLAUDE.md                        ← Generated Claude wrapper (`@AGENTS.md`)
├── .agents/
│   ├── agents.json                  ← MCP servers, profiles, config (commit this)
│   ├── local.json                   ← Secrets & overrides (gitignored)
│   ├── mcp_config.json              ← Generated Antigravity workspace MCP
│   ├── skills/                      ← Reusable workflow definitions
│   │   └── my-skill/SKILL.md
│   └── generated/                   ← Auto-generated artifacts (gitignored)
│
│  ┌─── Generated by `agents sync` ───┐
├── .mcp.json                         │  Claude Code + Copilot CLI
├── .codex/config.toml                │  Codex
├── .grok/config.toml                 │  Grok Build
├── .gemini/settings.json             │  Gemini CLI
├── .cursor/mcp.json                  │  Cursor
├── .vscode/mcp.json                  │  Copilot VS Code
├── .amp/settings.json                │  Amp
├── .factory/mcp.json                 │  Factory Droid
├── .kilo/kilo.jsonc                  │  Kilo
├── .devin/mcp_config.json            │  Devin CLI
├── .zed/settings.json                │  Zed
├── opencode.json                     │  OpenCode
├── .junie/mcp/mcp.json               │  Junie
└── .claude/skills → .agents/skills   │  Skill bridges

基特战略. 默认 source-only 模式,仅限 .agents/agents.json, (中文(简体) ), .agents/skills/ 财务报告和审定财务报表 AGENTS.md 承诺:同步生成的每分每分 每分每分每分每分每分每分每分每分每分每分每分每分每分每分 单位 commit-generated 模式 .gitignore,所以一个克隆人可以在不安装此 CLI 的情况下获得工作工具配置. 这就是你的行为 .mcp.json 其余的团队.

无论哪种方式,持有工具自身设置的文件(.zed/settings.json, (中文(简体) ), .amp/settings.json, (中文(简体) ), .kilo/kilo.jsonc和 .github/mcp.json 从未添加到 .gitignore:同步将其条目合并到它们中,然后将文件的其余部分,包括是否跟踪,留给您.

命令概览

设置同步( S)

诊断

MCP 服务器

简介

插件

技能和融合

全球模式

运行任何命令 --global (或 -g,或从 $HOME管理MCP服务器和整个机器的技能 ~/.agents/agents.json数字 :

agents init -g
agents connect -g --llm opencode,codex,grok
agents sync -g

仅具有用户级配置(Claude Desktop, Devin Desktop, Goose)的工具,都用两种模式写在那里.

代理插件

代理插件 1.0.0 由 ChatGPT 和 Codex, Cursor, GitHub Copilot, Kiro 和 VS 代码所读取, 是技能和 MCP 服务器的供应商中立软件包格式 。 软件包是一个目录 plugin.json,一个 mcp.json (单位:千美元) skills/ 文件夹,它接近什么 .agents/ 已经搁置.

agents plugin export --name my-stack --plugin-version 1.0.0

dist/agent-plugin/
├── plugin.json      $schema, name, version, description
├── mcp.json         $schema, mcpServers
└── skills/          copied from .agents/skills

导出已读 .agents/agents.json 只是,从来没有 local.json:什么是舰只 ${VAR} 来自已承诺文件的占位符,以及更改软件包需要的命令打印. ${PROJECT_ROOT} 成为规格的 ${PLUGIN_ROOT}。 。 。 .

向另一边走, agents plugin import ./some-plugin 在其插件名下添加软件包的服务器( n)my-stack.docs)所以您已经定义的任何东西都被替换.

预算

MCP服务器在代理做任何工作前的成本上下文:每个工具定义被加载到前面.

agents mcp budget

MCP context budget:
  everything              13 tools  ~  1916 tokens
  filesystem              11 tools  ~  1240 tokens
  broken                 error: spawn broken-server ENOENT

Servers        3
Tools          24
Estimated      ~3156 tokens of context

命令会讲MCP 2026-07-28 直接从stdio和可流的HTTP上,所以数字来自服务器本身. 以握手订正方式建造的服务器(2025-11-25 因此这两个时代都起作用。 Token计数是从工具定义的大小来估计的,而不是由模型来测量. 添加 --verbose 每个工具的分解,以及 --profile 以衡量一个简介的成本.

其配置仍然包含未解决的服务器 ${VAR} 被跳过而不是开始.

MCP 服务器示例

# From a catalog URL
agents mcp add https://mcpservers.org/servers/context7-mcp

# stdio server
agents mcp add my-server --command npx --arg @my-org/mcp-server --arg /path/to/project

# HTTP server with a secret header
agents mcp add company-api --url "https://api.company.com/mcp" \
  --secret-header "Authorization=Bearer YOUR_API_TOKEN"

# Only for specific tools
agents mcp add ide-server --command ide-mcp --target cursor --target zed

服务器定义支持 timeout, (中文(简体) ), connectTimeout, (中文(简体) ), tools, (中文(简体) ), disabledTools, (中文(简体) ), oauth, (中文(简体) ), headersHelper, (中文(简体) ), bearerTokenEnvVar 财务报告和审定财务报表 envFile。每个字段只写为文档工具,同步表示当一个字段被丢弃给不支持它的目标时.

数值支持 ${VAR} 财务报告和审定财务报表 ${VAR:-default}附加时 ${PROJECT_ROOT}。 。 。 .

警卫

• 隐藏的值被移动到 local.json 改为: ${PLACEHOLDER} 内 agents.json 当服务器被添加时.
• agents doctor 警告 字面上的秘密 在犯罪配置.
• 信封密钥和信头名称在到达配置文件或外壳之前被验证.
• agents plugin export 从不读 local.json。 。 。 .
• 配置此 CLI 不 gitignore 保存 ${VAR} 来自 agents.json,该值是否来自 local.json 或从你的外壳。 Amp, Zed 和 Kilo 与工具自己的设置共享一个文件,以及 .github/mcp.json 是文件小组审查;同步列表中哪些变量可以导出,以便这些工具能够解决. commit-generated 基于同样的原因,模式保留了每个生成的配置中的秘密.
• 重写此 CLI 的配置会保留它拥有的权限, 因此您限制的文件 0600 保持这种方式.

团队工作流程

领导制定项目:

agents start
agents mcp add https://mcpservers.org/servers/context7-mcp
git add .agents/agents.json .agents/skills/ AGENTS.md && git commit -m "Add agents config"

单位 source-only 模式是团队所需要的一切:每个克隆运行 agents sync 财务报告和审定财务报表 获取本地工具配置。 切换 syncMode 改为 commit-generated 如果你愿意的话 承诺 .mcp.json 其余的提供给没有安装CLI的人.

机上新成员 :

git clone <repo> && cd <repo>
agents start        # keeps the committed config, writes local tool files

CI: 爱奇艺

agents sync --check  # exits 2 when a tool config drifted from .agents/

财务问题

文档

• docs/agents-system.md - 同步、技能和生成文件如何工作
• docs/EXAMPLES.md - 项目设置
• CONTRIBUTING.md ——开发工作流程
• CHANGELOG.md ——发布历史

许可证

阿帕奇2.0 (英语). 见 自由主义 财务报告和审定财务报表 通知。 。 。 .