作为 AI/Agent 应用开发者,经常使用 Claude Code、Codex 或 OpenClaw 来管理AI Agent 任务,通过 MCP、Skills,尤其是命令行接口(CLI)来执行API等操作。
但我经常遇到一个问题:就是无法记住所有工具的复杂并且完整 CLI 命令、位置参数或选项,例如 `playwright-cli`、`claude` 或 `codex`。
对于人来讲,每次都去查网站的文档或 README.md 太麻烦了,对于Agent 来讲,从Skills文件中寻找到 Agent-Cli 如果执行失败,比如 Skills中命令行版本更新等原因,
会直接导致任务失败,白白浪费Token。 为了解决这个问题,发现了一个有趣的CLI 提示词的辅助工具 agtm: agent skills cli命令行管理提示词的工具。
适合人和Agent不同模式来执行,支持提示和自动补全功能。它可以帮助人类和代理快速发现并执行 CLI 命令,而无需记忆。
项目开源地址:https://github.com/aiagenta2z/agtm,
相关skills onekey gateway 下载:https://github.com/aiagenta2z/onekey-gateway
补全playwright 命令行例子,输入 play,然后找到 playwright的命令行。
agtm使用示例
假设你想测试本地环境Agent 能否通过 playwright的命令行来访问网页 playwright-cli` 的网页读取 (go to url)功能,但是忘记了具体命令行怎么写了。
那你只需要打出来 "play" 这个词,就可以根据提示词工具完整补全自己的命令行了。
1. 安装和设置
Installation
npm install -g @aiagenta2z/agtm agtm setup --hint # Builds a local RAG of CLI hints agtm run <provider_unique_id> <agent_cli>
agtm setup:会管理你本地的agent目录然后构建一个命令行 CLI的 RAG系统,构建提示词查找的索引。
agtm run :命令行执行+提示
参数含义:
provider_unique_id: 例如选择 微软的playwright 工具 (microsoft/playwright-cli), owner/repo (GitHub style)
agent_cli: 具体的命令行 the CLI commands in that repository
在 `agtm run` 后输入关键字,例如 `play`:
agtm run play
2. 执行Playwright 网页访问命令行
根据提示Guidance 逐步选择
Step 1: 选择建议的 Skill ID
这里我们选择 "microsoft/playwright-cli" 这个微软的命令行工具,这里的 unique_id
Skill ID suggestions: 1. microsoft/playwright-cli 2. paul-gauthier/aider 3. anthropic/claude-code 4. openai/codex-cli 5. googleworkspace/cli
Step 2: 选择 具体要执行命令行
Command hints: 1. playwright-cli goto <url> # navigate to a url 2. playwright-cli open [url] # open browser, optionally navigate to url
我们选择1 , playwright-cli goto
Step 3: 填写参数完成最终命令
playwright-cli goto https://www.baidu.com
补全之后的命令行
agtm run microsoft/playwright-cli playwright-cli goto https://www.google.com
Step 4. 点击Enter,直接执行
Agent Skills 模式执行
agent 如 Claude Code 或 Codex 等代理也可以使用提示系统自动执行命令。Agent 模式下,工具会搜索相关 Skill ID 和 CLI 提示进行非交互式执行:
可以通过下载skills,包含 agent-cli-hint-completion 命令行补全工具和 skills执行benchmark评测打分工具等。
1. 安装Skill
Skill |
description |
agent-cli-hint-completion |
Agent 命令行提示词Hint工具Skills |
agent-skills-evaluator |
Agent 记录每次skills执行输入输出,根据benchmark文件来评估skill |
安装 Skiil
npx agtm skills add aiagenta2z/agtm
2.使用agent run的skill
例如在 codex中,如果执行执行 playwright 失败,可以再次输入prompt:
Use Agtm to test run playwright to visit webpage https://www.baidu.com
这个时候agent 会调用 skills,内部的命令行
agtm run playwright --mode agent
示例输出完整的CLI的提示
Skill ID suggestions: 1. microsoft/playwright-cli - playwright-cli open [url] # 打开浏览器,可选导航到 URL - playwright-cli goto <url> # 导航到 URL
这让代理能够根据提示修改并正确执行 CLI 命令:
原理分析
1. 本地 CLI RAG:
agtm setup 会构建 CLI 提示的本地 RAG(trie)。先匹配 Skill ID,再提供所选 Skill 的 CLI 建议和提示。
Agent 模式:
代理可以自动使用 CLI 提示。非交互式模式下,工具会从本地 RAG 提供相关 CLI 建议。
当前支持 10–20 个仓库 ,50+ 个 CLI
可通过 GitHub 提交 CLI 提示或修改 .agtm/hints.json 扩展
Support CLI List, Please welcome to contrib
| unique_id | agent cli |
| microsoft/playwright-cli | playwright-cli open [url], playwright-cli goto |
| googleworkspace/cli | gws drive files list --params |
| aiagenta2z/onekey-gateway | onekey agent <unique_id> <api_id> <data_json |
| openai/codex-cli | codex, codex exec "[instruction]" |
| anthropic/claude-code | claude "[prompt]", claude --dangerously-skip-permissions |
| paul-gauthier/aider | aider --model [model_name], /test [command] |
| openinterpreter/open-interpreter | interpreter, interpreter --os |
| google-gemini/gemini-cli | gemini, gemini -p "[prompt] @[file/dir]", gemini --yolo, /memory add "[fact]", /mcp list, /restore |