如何使用 AnyCLI

AnyCLI 的目标是把 CLI 工具沉淀为结构化能力单元：人类与 Agent 统一用 slug 定位工具，按站点记录生成安装命令与示例使用方式。

AI Agent 如何使用（推荐从这里开始）

Agent 的最佳路径是：先用 search 拿到最小 JSON（含 agentHints 与安装命令），再决定是否执行安装。

# 1) 精确查询：slug -> 最小 JSON（含 agentHints）
anycli search <slug> --json

# 2) 安装：默认 dry-run（只返回将执行的命令，不执行）
anycli install <slug> --json

# 3) 确认后再执行安装
anycli install <slug> --yes --json

你可以把下面这些提示词模板直接交给 AI Agent:

示例 1：安装 AnyCLI + 工具 + 验证
请使用 AnyCLI 安装并验证 CLI 工具，工具 slug 为 {{slug}}。严格按以下步骤操作：

0) 安装 AnyCLI（如果尚未安装）：
   npm i -g @lightcity/anycli
   # 安装完成后，可以使用 `anycli --version` 确认安装成功

1) 搜索工具：
   anycli search {{slug}} --json

2) 查看搜索结果，重点关注 agentHints/example_usage：
   - 选择一条最安全的验证命令（例如 --help 或 --version）

3) 安装工具：
   a) 安全检查：
      anycli install {{slug}} --json
      # 确认 install.command 是安全的
   b) 安装执行：
      anycli install {{slug}} --yes

4) 验证工具：
   - 运行最小安全命令（例如 {{binary}} --help 或 example_usage 中安全命令）
   - 总结输出，确保工具可用

提示词2：只生成命令，不执行

请使用 AnyCLI 搜索 CLI 工具 {{slug}}，但不要执行安装。严格按以下步骤：

0) 确认 AnyCLI 已安装：
   npm i -g @lightcity/anycli
   # 可使用 anycli --version 检查

1) 搜索工具：
   anycli search {{slug}} --json

2) 输出：
   - 推荐的安装命令（例如 anycli install {{slug}} --yes）
   - 1～3 条推荐的后续使用命令（优先 agentHints/example_usage 中的安全命令）
   - 需要注意的前置条件（如果 agentHints.when_to_use 提到鉴权或配置，请列出）

⚠️ 输出仅包含命令和注意事项，不要尝试执行工具。

安装 anycli（人类 / Agent 通用）

npm i -g @lightcity/anycli

默认连接 ANYCLI_BASE_URL（不设置时为 http://localhost:3000）。

人类如何使用

如果你只想快速上手某个工具：先查 search，再用 install 打印安装命令（确认无误后加 --yes）。

anycli search <slug>
anycli install <slug>
anycli install <slug> --yes

发布与维护

发布页登录后进入发布页，按必填项提交工具信息。站点会自动生成 agentHints，并在详情页展示「Agent 提示」。