agmesh

Agent collaboration, model routing, and CI review CLI.

agmesh is the public npm binary package that provides the agmesh command. It brings agmesh workflows, Task Contracts, subagent collaboration rules, model candidate chains, CI PR/MR review, and Goal Forge design review into local repositories.

English Quick Start

Install

npm install -g agmesh
agmesh install
agmesh deploy .
agmesh status

Temporary project-only use:

npx agmesh deploy .
npx agmesh status

Common commands

• agmesh deploy .: enable agmesh workflows and collaboration rules in the current git repository.
• agmesh status: inspect installation, project configuration, and Goal Forge runtime.
• agmesh automation status .: inspect coordination DB task queue and mailbox state.
• agmesh automation doctor .: diagnose automation configuration, CI visibility, and queue drift.
• agmesh model init --model-profile pro --probe: probe available models and write candidate chains.
• agmesh goal-forge status .: confirm the bundled Goal Forge runtime.
• agmesh goal-forge init . "<goal>": create a design-review run for architecture, API, data model, or high-risk plans.

Distribution model

The main package only contains a JS launcher. The real compiled binary comes from the optional dependency package for the current platform, so the command still works with npm install --ignore-scripts and does not depend on postinstall file copying.

• @agmesh/darwin-arm64
• @agmesh/darwin-x64
• @agmesh/linux-x64
• @agmesh/linux-arm64
• @agmesh/linux-x64-musl
• @agmesh/win32-x64

Privacy and safety boundaries

• npm install -g agmesh only installs the command. Run agmesh install once to install Codex global precheck rules, skills, and the shell hook.
• No project tasks run during package installation and no telemetry is sent during npm install/postinstall.
• Runtime diagnostics never collect source code, prompts, diffs, environment variables, secrets, tokens, remote URLs, or raw stdout/stderr.
• Anonymous diagnostics can be inspected with agmesh telemetry status and disabled with agmesh telemetry revoke.
• Publishing, signing, and maintainer-only operations are not executed from the npm package.

The source-development command is agent-team; normal users should prefer the agmesh npm binary package.

中文

Agent 协同、模型路由与 CI 审查框架。

agmesh 是公开 npm 二进制分发包，提供 agmesh 命令。它会把 agmesh workflow、Task Contract、子代理协作规则、模型候选链、CI PR/MR 审查和 Goal Forge 设计质证带到本地项目里。

安装

npm install -g agmesh
agmesh install
agmesh deploy .
agmesh status

临时只接入当前项目可以直接用 npx：

npx agmesh deploy .
npx agmesh status

常用命令

• agmesh deploy .：在当前 git 项目启用 agmesh workflow 和协作规则。
• agmesh status：查看当前安装、项目配置和 Goal Forge runtime。
• agmesh automation status .：查看 coordination DB 任务队列和 mailbox 状态。
• agmesh automation doctor .：诊断自动化配置、CI 可见性和队列漂移。
• agmesh model init --model-profile pro --probe：探测可用模型并写入候选链。
• agmesh goal-forge status .：确认内置 Goal Forge runtime。
• agmesh goal-forge init . "<goal>"：为架构、API、数据模型或高风险方案创建设计质证 run。

分发形态

主包只包含一个 JS launcher。真正的编译二进制由当前平台对应的 optional dependency 提供，因此 npm install --ignore-scripts 也可以使用，不依赖 postinstall 复制文件。

• @agmesh/darwin-arm64
• @agmesh/darwin-x64
• @agmesh/linux-x64
• @agmesh/linux-arm64
• @agmesh/linux-x64-musl
• @agmesh/win32-x64

隐私与安全边界

• npm install -g agmesh 只安装命令；运行一次 agmesh install 才会安装 Codex 全局预检规则、skills 和 shell hook。
• npm install/postinstall 阶段不会运行项目任务，也不会发送遥测。
• 运行命令时不会采集源码、prompt、diff、环境变量、secret、token、remote URL 或原始 stdout/stderr。
• 匿名诊断遥测可通过 agmesh telemetry status 查看，通过 agmesh telemetry revoke 关闭。
• 发布、签名和维护者操作不在 npm 包内执行。

源码开发版命令是 agent-team；普通用户优先使用这里的 agmesh npm 二进制。