Agents Market Installer

Agents Market

🧩 面向 Agent 的 Subagent 市场与安装器。把专业 coding subagents 安全、可验证、可维护地安装到 Claude Code、Codex、OpenCode 项目里。

English | 在线市场 | Preview Release | 隐私说明 | 支持

Agents Market 解决的问题很直接：专业 subagent 很有价值，但大多数用户不会自己发现、编写、验证、适配并长期维护每一个 agent 文件。这个项目提供一个带治理能力的 agent 市场，让编码 Agent 或开发者可以按项目场景推荐、预览、安装、更新、回滚和审计 agent packs。

✨ 核心能力

图标	能力	说明
🤖	Agent-native	CLI 输出结构化 JSON，适合 Claude Code、Codex、OpenCode 或未来 MCP/Agent 调用
🧰	多端生成	同一套 registry 可以生成 Claude Code、Codex、OpenCode 原生 agent 文件
🏷️	市场分层	core 是深度维护的精选 coding agents，community 是带 provenance 的社区导入内容
🛡️	安全预览	apply --json 默认只预览推荐、审计、策略、diff，不直接写文件
🔁	生命周期管理	manifest 记录安装内容，支持 drift 检测、resolve、update、rollback、uninstall
🔐	供应链信任	registry bundle 支持 Ed25519 签名、checksum、lock、verify-lock、doctor 闭环
🧾	Provenance	社区导入 agent 带 source、license、commit、source checksum
⚙️	CI 自动化	可生成 GitHub workflow，持续检查 registry lock、drift、outdated、update preview、doctor
🌐	静态市场	生成 index.html、catalog.json、agents-market.json，可部署到 GitHub Pages
🚫	零遥测	no telemetry or analytics；不采集遥测或分析数据，只在显式远程 registry/catalog/import/release 场景访问网络

🎯 支持目标

图标	工具	输出位置
🟣	Claude Code	.claude/agents/*.md
⚫	Codex	.codex/agents/*.toml
🔵	OpenCode	.opencode/agents/*.md

📦 安装

方式	命令	适合
🍺 Homebrew	brew install tt-a1i/tap/agents-market	macOS / Linux 日常使用
⚡ npx 免安装	npx github:tt-a1i/agents-market#preview-0.1.0 <command>	一次性试用、CI
🛡️ 校验安装脚本	install.sh（见下方）	要求 checksum / attestation 验证的环境
🔌 Claude Code 插件	/plugin marketplace add tt-a1i/agents-market	在 Claude Code 会话内自助安装 packs
📦 npm	npm install -g @agents-market/cli	即将发布

🍺 Homebrew

brew install tt-a1i/tap/agents-market

Formula 在 tt-a1i/homebrew-tap，当前从 commit 固定的 preview 源码归档构建，npm 发布后会切换到 registry tarball。

⚡ npx 免安装

不写入任何全局文件，适合试用和 CI：

npx github:tt-a1i/agents-market#preview-0.1.0 init --target all
npx github:tt-a1i/agents-market#preview-0.1.0 recommend

🛡️ 校验安装脚本

从 GitHub Release 安装，写入前校验 checksum，并用 npm install -g --ignore-scripts 跳过 npm 生命周期脚本：

curl -fsSL https://github.com/tt-a1i/agents-market/releases/download/preview-0.1.0/install.sh | sh

要求 GitHub Artifact Attestation 验证（需要 gh CLI）：

curl -fsSL https://github.com/tt-a1i/agents-market/releases/download/preview-0.1.0/install.sh | AGENTS_MARKET_REQUIRE_ATTESTATION=1 sh

📦 npm（即将发布）

npm install -g @agents-market/cli
npx @agents-market/cli init --target all

🧑‍💻 本地开发

npm install
npm run build
npm run dev -- recommend
npm run dev -- apply --target all --json

🚀 快速开始

装好 CLI 后（任选上面一种方式）：

# 1. 初始化：锁 registry、安装 agent-native 集成、检测项目并给出推荐
agents-market init --target all

# 2. 预览推荐 pack 的审计、策略检查和文件 diff（不写文件）
agents-market apply --target all --json

# 3. 确认后写入
agents-market apply starter-dev-pack --target all --yes

# 4. 健康检查
agents-market status --json
agents-market doctor --strict --json

🔌 Claude Code 插件市场

Claude Code 用户可以不碰项目文件，直接装 installer skill：

/plugin marketplace add tt-a1i/agents-market
/plugin install agents-market-installer@agents-market

装好后在会话里让 Claude 推荐并安装 subagent packs，skill 会走同样的 apply --json 预览 → 确认 → apply --yes 安装流程。插件源码在 integrations/claude-plugin/，市场清单在 .claude-plugin/marketplace.json。

🧭 推荐工作流

1. 🧱 初始化项目

agents-market init --target all
agents-market init --target claude --dry-run --json

init 会预览或写入：

• .agents-market/registry-lock.json
• Claude/Codex/OpenCode 的 agent-native installer 入口
• 项目信号检测结果
• 推荐 pack
• 下一步 apply 和 doctor 命令

2. 🤖 让 Agent 选择 pack

agents-market recommend --json
agents-market apply --target all --json

apply --json 是推荐的 agent-native 主入口。它会一次性返回：

• 项目信号
• 推荐或指定 pack
• audit 风险
• compatibility 结果
• policy 结果
• 文件 diff
• nextCommands

3. 🔎 搜索具体能力

agents-market search accessibility --target claude
agents-market search "next performance" --type packs
agents-market search review --tier core --json
agents-market search --type agents --category frontend --json

4. 🧪 安装前审计

agents-market audit security-pack --target all --json
agents-market policy check security-pack --target all --json
agents-market diff security-pack --target all --json
agents-market plan security-pack --target claude --policy-preset balanced --json

5. ✅ 确认安装

agents-market apply security-pack --target all --policy-preset balanced --yes
agents-market status --json
agents-market doctor --strict --json

🏷️ 市场分层

每个 agent 和 pack 都有 tier：