@aiagenta2z/agtm 1.1.0 → 1.1.2

package/README.md

@@ -3,14 +3,18 @@
 
 [GitHub](https://github.com/aiagenta2z/agtm)|[AI Agent Marketplace CLI Doc](https://www.deepnlp.org/doc/ai_agent_marketplace)|[DeepNLP AI Agent Marketplace](https://www.deepnlp.org/store/ai-agent) | [OneKey Gateway](https://deepnlp.org/doc/onekey_gateway) | [Agent MCP OneKey Router Ranking](https://www.deepnlp.org/agent/rankings) | [NodeJS agtm](https://www.npmjs.com/package/@aiagenta2z/agtm)
 
-`agtm` (AI Agent Management CLI) unifies skill management, agent registration, marketplace search, and provider CLI execution. Install skills from GitHub, log and rate skill runs, upload agent metadata to registries, query the public marketplace, and run agent toolchains with fuzzy hints.
+`agtm` (AI Agent Manager CLI) unifies skill management, agent registration, marketplace search, and provider CLI execution. Install skills from GitHub, log and rate skill runs, upload agent metadata to registries, query the public marketplace, and run agent toolchains with fuzzy hints.
 
 ## Features
 
-*`agtm skills`*: Manage Skills, Add Skills, List Skills, Log Skills Performance, Skills performance Evaluator, compare to realworld benchmarks   
-*`agtm upload`*: AI Agent Registry, register local agent meta information of json or yaml format(agent.json/agent.yaml) or sync your github source meta including README.md     
-*`agtm search`*: Search the open source AI Agent Marketplace, including github community, huggingface community, product hunt community, deepnlp ai agent marketplace index, etc     
-*`agtm run`*: Run agent clis, don't need to remember, with the powerful hints and completion ability, just type a few characters and "--hint" will help you complete the command line.   
+**agtm skills**: Manage Skills, Add Skills, List Skills, Log Skills Performance, Skills performance Evaluator, compare to realworld benchmarks   
+**agtm upload**: AI Agent Registry, register local agent meta information of json or yaml format(agent.json/agent.yaml) or sync your github source meta including README.md     
+**agtm search**: Search the open source AI Agent Marketplace, including github community, huggingface community, product hunt community, deepnlp ai agent marketplace index, etc     
+**agtm run**: Run agent clis, don't need to remember, with the powerful hints and completion ability, just type a few characters and "--hint" will help you complete the command line.   
+
+The agent cli run hint from "play" to "playwright" complete cli.
+
+<img src="docs/static/snapshot_playwright_google.png" width="400px" />
 
 Furthermore, `agtm` provides memory to track skill outputs and enables performance rating against industry job level benchmarks. This allows you to score each skill execution and assign a professional tier to your AI Agent's capabilities—for example, evaluating its performance as equivalent to that of an L3 or L5 software engineer, marketing professional, etc.
 
@@ -18,6 +22,7 @@ Furthermore, `agtm` provides memory to track skill outputs and enables performan
 skill_id             run_times  score  level
 -------------------  ---------  -----  -----
 code_success_skills  5          0.9     L3(100%)    
+code_fail_skills  4          0.9     L3(100%)    
 ```
 
 ## Quickstart
@@ -29,20 +34,59 @@ code_success_skills  5          0.9     L3(100%)
 npm install -g @aiagenta2z/agtm
 ```
 
+### Run a playwright Webpage cli
 Setup hint and skills benchmark 
 ```shell
-agtm setup --levels  ## Needed before `agtm rate`, to sync the benchmarks json to local folder 
-agtm setup --hint    ## Needed before `agtm run` 
+npx agtm setup --levels  ## Needed before `agtm rate`, to sync the benchmarks json to local folder 
+npx agtm setup --hint    ## Needed before `agtm run` 
+```
+
+```shell
+npm install -g @playwright/cli@latest
+agtm run play
+
+### hint to "playwright-cli goto" command line
 ```
 
-Agtm CLI Options
+Result Hint
+```shell
+Selected Skill/Cli is microsoft/playwright-cli
+
+Enter command to run (leave empty to list cli hints): play
+
+Complete the Cli with your arguments or leave blank and press Enter
+
+Final command line [playwright-cli goto <url>]:
+playwright-cli goto https://www.google.com
+agtm run microsoft/playwright-cli playwright-cli goto https://www.google.com
+
+### Browser `default` opened with pid 4603.
+- default:
+  - browser-type: chrome
+  - user-data-dir: <in-memory>
+  - headed: false
+---
+
+### Ran Playwright code
+await page.goto('https://www.google.com');
+
+
+### Page
+- Page URL: https://www.google.com/
+- Page Title: Google
+### Snapshot
+- [Snapshot](.playwright-cli/page-2026-03-22T03-08-05-614Z.yml)
+```
+
+
+## Agtm CLI Options
 
 | CLI         | Command and Options                       | Document                       |
 |-------------|-------------------------------------------|--------------------------------|
-| agtm skills | add, list, log, rate                      | [Doc](../docs/skills/README.md)   |
-| agtm search | --q query                                 | [Doc](../docs/registry/README.md) |
-| agtm upload | --github  --config to local agent meta    | [Doc](../docs/registry/README.md) |
-| agtm run    | --hint agent-cli hint and auto completion | [Doc](../docs/run/README.md)      |
+| agtm skills | add, list, log, rate                      | [Doc](./docs/skills/README.md)  |
+| agtm search | --q query                                 | [Doc](./docs/registry/README.md) |
+| agtm upload | --github  --config to local agent meta    | [Doc](./docs/registry/README.md) |
+| agtm run    | --hint agent-cli hint and auto completion | [Doc](./docs/run/README.md)     |
 
 ## `skills`  
 
@@ -52,27 +96,27 @@ Download and add skills to your agent directory.
 
 #### Usage
 ```
-agtm skills add <unique_id>
-agtm skills add <github_url>
-agtm skills add <github_url> -a <agent_id>
-agtm skills add <owner_id/repo_id> -s <skill_id>
+npx agtm skills add <unique_id>
+npx agtm skills add <github_url>
+npx agtm skills add <github_url> -a <agent_id>
+npx agtm skills add <owner_id/repo_id> -s <skill_id>
 ```
 
 #### Example
 ```
-agtm skills add anthropics/skills -a claude-code  ## install skills only to claude-codex
-agtm skills add msitarzewski/agency-agents
-agtm skills add aiagenta2z/onekey-gateway
-agtm skills add msitarzewski/agency-agents -s academic-anthropologist -a codex
-agtm skills add anthropics/skills -s skill-creator -a claude-code --global
+npx agtm skills add anthropics/skills -a claude-code  ## install skills only to claude-codex
+npx agtm skills add msitarzewski/agency-agents
+npx agtm skills add aiagenta2z/onekey-gateway
+npx agtm skills add msitarzewski/agency-agents -s academic-anthropologist -a codex
+npx agtm skills add anthropics/skills -s skill-creator -a claude-code --global
 ```
 
 ### skills list
 
 #### Usage
 ```
-agtm skills list
-agtm skills list --agent <agent_id> --global
+npx agtm skills list
+npx agtm skills list --agent <agent_id> --global
 ```
 Lists installed skills with `agent`, `skill_id`, `description`, install `path`, average `score`, and aggregated `level` (if ratings exist).
 
@@ -80,9 +124,9 @@ Lists installed skills with `agent`, `skill_id`, `description`, install `path`,
 
 #### Example
 ```
-agtm skills list
-agtm skills list --agent codex
-agtm skills list --agent claude-code --global
+npx agtm skills list
+npx agtm skills list --agent codex
+npx agtm skills list --agent claude-code --global
 ```
 
 
@@ -90,15 +134,16 @@ agtm skills list --agent claude-code --global
 
 #### Usage
 ```
-agtm skills log <skill_id> --data '<json_payload>'
+npx agtm skills log <skill_id> --data '<json_payload>'
 ```
+
 - Persists a run record at `.agtm/skills/log/<uuid>.json` (or the `--logDir` you supply).
 - `<json_payload>` must contain at least `input` and `output`; optional fields (meta, rating, level) are accepted.
 
 #### Example
 ```
-agtm skills log <skill_id> --data '{"input":"write a website for store","output":"success"}'
-agtm skills log code_success_skills --data '{"input":"generate sql","output":"ok","meta":{"agent":"claude-code"}}'
+npx agtm skills log <skill_id> --data '{"input":"write a website for store","output":"success"}'
+npx agtm skills log code_success_skills --data '{"input":"generate sql","output":"ok","meta":{"agent":"claude-code"}}'
 ```
 
 ### skills rate
@@ -107,14 +152,14 @@ agtm skills log code_success_skills --data '{"input":"generate sql","output":"ok
 
 To use the rate command, have to setup the benchmark levels configuration. save to `./agtm/levels/*.json` files
 ```shell
-agtm setup --levels
+npx agtm setup --levels
 ```
 
 #### Usage
 ```
-agtm skills rate prepare --skill_id <skill_id> --prompt "<eval_prompt>" --benchmark <path/benchmark.json>
-agtm skills rate apply   --skill_id <skill_id> --result '<result_json>'
-agtm skills rate show    --skill_id <skill_id>
+npx agtm skills rate prepare --skill_id <skill_id> --prompt "<eval_prompt>" --benchmark <path/benchmark.json>
+npx agtm skills rate apply   --skill_id <skill_id> --result '<result_json>'
+npx agtm skills rate show    --skill_id <skill_id>
 ```
 - `prepare` exports logs plus the top benchmark slices (e.g., Google SWE L3–L7) for an external evaluator.
 - `apply` writes evaluator outputs (`rating`, `level`) back to each log.
@@ -122,9 +167,9 @@ agtm skills rate show    --skill_id <skill_id>
 
 #### Example
 ```
-agtm skills rate prepare --skill_id code_success_skills --prompt "Evaluate the results" --benchmark path/customized_agent_benchmark.json
-agtm skills rate apply --skill_id code_success_skills --result '{"results":[{"log_id":"3679a3fe-4d97-4eb1-83bc-f83d711be195","rating":0.90,"level":"L4"}]}'
-agtm skills rate show --skill_id code_success_skills
+npx agtm skills rate prepare --skill_id code_success_skills --prompt "Evaluate the results" --benchmark path/customized_agent_benchmark.json
+npx agtm skills rate apply --skill_id code_success_skills --result '{"results":[{"log_id":"3679a3fe-4d97-4eb1-83bc-f83d711be195","rating":0.90,"level":"L4"}]}'
+npx agtm skills rate show --skill_id code_success_skills
 ```
 Sample output:
 ```

package/data/config/hints/base_hints.json

@@ -1,21 +1,261 @@
 {
   "microsoft/playwright-cli": {
     "hints": [
-      {
-        "cli": "playwright-cli open [url]",
-        "hint": "open browser, optionally navigate to url"
-      },
-      {
-        "cli": "playwright-cli goto <url> ",
-        "hint": "navigate to a url"
-      }
+      { "cli": "playwright-cli open [url]", "hint": "open browser, optionally navigate to url" },
+      { "cli": "playwright-cli goto <url>", "hint": "navigate to a url" },
+      { "cli": "playwright-cli close", "hint": "close the browser page" },
+      { "cli": "playwright-cli type <text>", "hint": "type text into editable element" },
+      { "cli": "playwright-cli click <ref> [button]", "hint": "click an element" },
+      { "cli": "playwright-cli dblclick <ref> [button]", "hint": "double click an element" },
+      { "cli": "playwright-cli fill <ref> <text>", "hint": "fill text into input field" },
+      { "cli": "playwright-cli drag <startRef> <endRef>", "hint": "drag and drop between elements" },
+      { "cli": "playwright-cli hover <ref>", "hint": "hover over element" },
+      { "cli": "playwright-cli select <ref> <val>", "hint": "select dropdown option" },
+      { "cli": "playwright-cli upload <file>", "hint": "upload file(s)" },
+      { "cli": "playwright-cli check <ref>", "hint": "check checkbox or radio" },
+      { "cli": "playwright-cli uncheck <ref>", "hint": "uncheck checkbox or radio" },
+      { "cli": "playwright-cli snapshot", "hint": "capture page snapshot" },
+      { "cli": "playwright-cli snapshot --filename=<file>", "hint": "save snapshot to file" },
+      { "cli": "playwright-cli eval <func> [ref]", "hint": "run JS on page or element" },
+      { "cli": "playwright-cli dialog-accept [prompt]", "hint": "accept dialog" },
+      { "cli": "playwright-cli dialog-dismiss", "hint": "dismiss dialog" },
+      { "cli": "playwright-cli resize <w> <h>", "hint": "resize browser window" },
+      { "cli": "playwright-cli go-back", "hint": "go to previous page" },
+      { "cli": "playwright-cli go-forward", "hint": "go to next page" },
+      { "cli": "playwright-cli reload", "hint": "reload current page" },
+      { "cli": "playwright-cli press <key>", "hint": "press a key" },
+      { "cli": "playwright-cli keydown <key>", "hint": "key down event" },
+      { "cli": "playwright-cli keyup <key>", "hint": "key up event" },
+      { "cli": "playwright-cli mousemove <x> <y>", "hint": "move mouse" },
+      { "cli": "playwright-cli mousedown [button]", "hint": "mouse button down" },
+      { "cli": "playwright-cli mouseup [button]", "hint": "mouse button up" },
+      { "cli": "playwright-cli mousewheel <dx> <dy>", "hint": "scroll mouse wheel" },
+      { "cli": "playwright-cli screenshot [ref]", "hint": "take screenshot" },
+      { "cli": "playwright-cli screenshot --filename=<file>", "hint": "save screenshot to file" },
+      { "cli": "playwright-cli pdf", "hint": "save page as pdf" },
+      { "cli": "playwright-cli pdf --filename=<file>", "hint": "save pdf to file" },
+      { "cli": "playwright-cli tab-list", "hint": "list browser tabs" },
+      { "cli": "playwright-cli tab-new [url]", "hint": "open new tab" },
+      { "cli": "playwright-cli tab-close [index]", "hint": "close tab" },
+      { "cli": "playwright-cli tab-select <index>", "hint": "switch tab" },
+      { "cli": "playwright-cli state-save [filename]", "hint": "save storage state" },
+      { "cli": "playwright-cli state-load <filename>", "hint": "load storage state" },
+      { "cli": "playwright-cli cookie-list [--domain]", "hint": "list cookies" },
+      { "cli": "playwright-cli cookie-get <name>", "hint": "get cookie value" },
+      { "cli": "playwright-cli cookie-set <name> <value>", "hint": "set cookie" },
+      { "cli": "playwright-cli cookie-delete <name>", "hint": "delete cookie" },
+      { "cli": "playwright-cli cookie-clear", "hint": "clear all cookies" },
+      { "cli": "playwright-cli localstorage-list", "hint": "list localStorage" },
+      { "cli": "playwright-cli localstorage-get <key>", "hint": "get localStorage value" },
+      { "cli": "playwright-cli localstorage-set <key> <value>", "hint": "set localStorage" },
+      { "cli": "playwright-cli localstorage-delete <key>", "hint": "delete localStorage entry" },
+      { "cli": "playwright-cli localstorage-clear", "hint": "clear localStorage" },
+      { "cli": "playwright-cli sessionstorage-list", "hint": "list sessionStorage" },
+      { "cli": "playwright-cli sessionstorage-get <key>", "hint": "get sessionStorage value" },
+      { "cli": "playwright-cli sessionstorage-set <key> <value>", "hint": "set sessionStorage" },
+      { "cli": "playwright-cli sessionstorage-delete <key>", "hint": "delete sessionStorage entry" },
+      { "cli": "playwright-cli sessionstorage-clear", "hint": "clear sessionStorage" },
+      { "cli": "playwright-cli route <pattern> [opts]", "hint": "mock network requests" },
+      { "cli": "playwright-cli route-list", "hint": "list routes" },
+      { "cli": "playwright-cli unroute [pattern]", "hint": "remove routes" },
+      { "cli": "playwright-cli console [min-level]", "hint": "show console logs" },
+      { "cli": "playwright-cli network", "hint": "list network requests" },
+      { "cli": "playwright-cli run-code <code>", "hint": "execute playwright code" },
+      { "cli": "playwright-cli tracing-start", "hint": "start tracing" },
+      { "cli": "playwright-cli tracing-stop", "hint": "stop tracing" },
+      { "cli": "playwright-cli video-start", "hint": "start video recording" },
+      { "cli": "playwright-cli video-stop [filename]", "hint": "stop video recording" },
+      { "cli": "playwright-cli open --browser=<name>", "hint": "open with specific browser" },
+      { "cli": "playwright-cli open --extension", "hint": "connect via extension" },
+      { "cli": "playwright-cli open --persistent", "hint": "use persistent profile" },
+      { "cli": "playwright-cli open --profile=<path>", "hint": "use custom profile" },
+      { "cli": "playwright-cli open --config=<file>", "hint": "use config file" },
+      { "cli": "playwright-cli delete-data", "hint": "delete browser data" },
+      { "cli": "playwright-cli -s=<name> <cmd>", "hint": "run command in named session" },
+      { "cli": "playwright-cli -s=<name> close", "hint": "close named session" },
+      { "cli": "playwright-cli -s=<name> delete-data", "hint": "delete session data" },
+      { "cli": "playwright-cli list", "hint": "list all sessions" },
+      { "cli": "playwright-cli close-all", "hint": "close all browsers" },
+      { "cli": "playwright-cli kill-all", "hint": "force kill all browsers" }
     ]
   },
   "googleworkspace/cli": {
     "hints": [
       {
-        "cli": "gws drive files list --params",
-        "hint": "List the 10 most recent files"
+        "cli": "gws auth setup",
+        "hint": "initialize Google Cloud project and OAuth"
+      },
+      {
+        "cli": "gws auth login",
+        "hint": "login with OAuth credentials"
+      },
+      {
+        "cli": "gws auth login --scopes <services>",
+        "hint": "login with specific scopes"
+      },
+      {
+        "cli": "gws auth export --unmasked",
+        "hint": "export credentials for CI or headless usage"
+      },
+      {
+        "cli": "gws <service> <resource> <method> --params '<json>'",
+        "hint": "call any Google Workspace API method"
+      },
+      {
+        "cli": "gws <service> <resource> <method> --json '<json>'",
+        "hint": "send JSON body payload"
+      },
+      {
+        "cli": "gws schema <service.resource.method>",
+        "hint": "inspect API request/response schema"
+      },
+      {
+        "cli": "gws drive files list --params '{\"pageSize\": 10}'",
+        "hint": "list recent Drive files"
+      },
+      {
+        "cli": "gws drive files list --params '{\"pageSize\": 100}' --page-all",
+        "hint": "stream paginated results as NDJSON"
+      },
+      {
+        "cli": "gws drive files create --json '{\"name\": \"file\"}' --upload <file>",
+        "hint": "upload file to Drive"
+      },
+      {
+        "cli": "gws sheets spreadsheets create --json '{\"properties\": {\"title\": \"Sheet\"}}'",
+        "hint": "create a spreadsheet"
+      },
+      {
+        "cli": "gws sheets spreadsheets values get --params '<json>'",
+        "hint": "read spreadsheet values"
+      },
+      {
+        "cli": "gws sheets spreadsheets values append --params '<json>' --json '<json>'",
+        "hint": "append rows to spreadsheet"
+      },
+      {
+        "cli": "gws gmail users messages list --params '<json>'",
+        "hint": "list Gmail messages"
+      },
+      {
+        "cli": "gws gmail users messages get --params '<json>'",
+        "hint": "get email content"
+      },
+      {
+        "cli": "gws chat spaces messages create --params '<json>' --json '<json>'",
+        "hint": "send Chat message"
+      },
+      {
+        "cli": "gws calendar events list --params '<json>'",
+        "hint": "list calendar events"
+      },
+      {
+        "cli": "gws calendar events insert --json '<json>'",
+        "hint": "create calendar event"
+      },
+      {
+        "cli": "gws docs documents get --params '<json>'",
+        "hint": "read a document"
+      },
+      {
+        "cli": "gws <service> --help",
+        "hint": "show all commands and helper methods for a service"
+      },
+      {
+        "cli": "gws gmail +send --to <email> --subject <text> --body <text>",
+        "hint": "send an email"
+      },
+      {
+        "cli": "gws gmail +reply --message-id <id> --body <text>",
+        "hint": "reply to an email"
+      },
+      {
+        "cli": "gws gmail +triage",
+        "hint": "show unread inbox summary"
+      },
+      {
+        "cli": "gws gmail +watch",
+        "hint": "stream new emails as NDJSON"
+      },
+      {
+        "cli": "gws sheets +append --spreadsheet <id> --values <csv>",
+        "hint": "append row to spreadsheet"
+      },
+      {
+        "cli": "gws sheets +read --spreadsheet <id>",
+        "hint": "read spreadsheet values"
+      },
+      {
+        "cli": "gws docs +write --document <id> --text <text>",
+        "hint": "append text to document"
+      },
+      {
+        "cli": "gws drive +upload <file> --name <name>",
+        "hint": "upload file with metadata"
+      },
+      {
+        "cli": "gws calendar +insert",
+        "hint": "create calendar event quickly"
+      },
+      {
+        "cli": "gws calendar +agenda",
+        "hint": "show upcoming events"
+      },
+      {
+        "cli": "gws calendar +agenda --timezone <tz>",
+        "hint": "show agenda in specific timezone"
+      },
+      {
+        "cli": "gws workflow +standup-report",
+        "hint": "generate daily standup summary"
+      },
+      {
+        "cli": "gws workflow +meeting-prep",
+        "hint": "prepare for upcoming meeting"
+      },
+      {
+        "cli": "gws workflow +weekly-digest",
+        "hint": "weekly summary of meetings and emails"
+      },
+      {
+        "cli": "gws workflow +email-to-task",
+        "hint": "convert email into task"
+      },
+      {
+        "cli": "gws chat +send --space <id> --text <message>",
+        "hint": "send chat message"
+      },
+      {
+        "cli": "gws events +subscribe",
+        "hint": "subscribe to workspace events"
+      },
+      {
+        "cli": "gws events +renew",
+        "hint": "renew event subscription"
+      },
+      {
+        "cli": "gws modelarmor +sanitize-prompt",
+        "hint": "sanitize user prompt"
+      },
+      {
+        "cli": "gws modelarmor +sanitize-response",
+        "hint": "sanitize model response"
+      },
+      {
+        "cli": "gws <service> <resource> <method> --dry-run",
+        "hint": "preview API request without executing"
+      },
+      {
+        "cli": "gws <service> <resource> <method> --page-all",
+        "hint": "auto paginate results"
+      },
+      {
+        "cli": "gws <service> <resource> <method> --page-limit <n>",
+        "hint": "limit number of pages"
+      },
+      {
+        "cli": "gws <service> <resource> <method> --sanitize <template>",
+        "hint": "sanitize API response using Model Armor"
       }
     ]
   },
@@ -36,10 +276,514 @@
       {
         "cli": "onekey llm --payload <json|@file>",
         "hint": "Run a raw LLM request using a pre-formatted JSON payload or configuration file"
+      },
+      {
+        "cli": "onekey agent bing-image-search-mcp/bing-image-search-mcp search_images '{\"query\": \"Eiffel Tower sunset\", \"limit\": 5}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent bing-image-search-mcp/bing-image-search-mcp search_images_batch '{\"query_list\": [\"Eiffel Tower sunset\", \"Louvre at night\"], \"limit\": 3}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent baidu-maps-sse/baidu-maps-sse maps_geocode '{\"address\": \"Times Square, New York\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent baidu-maps-sse/baidu-maps-sse maps_reverse_geocode '{\"latitude\": 40.758, \"longitude\": -73.9855}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent baidu-maps-sse/baidu-maps-sse maps_search_places '{\"query\": \"Italian restaurants\", \"location\": {\"latitude\": 40.758, \"longitude\": -73.9855}, \"radius\": 500}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent baidu-maps-sse/baidu-maps-sse maps_place_details '{\"place_id\": \"ChIJmQJIxlVYwokRLgeuocVOGVU\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent baidu-maps-sse/baidu-maps-sse maps_distance_matrix '{\"origins\": [\"Times Square, NY\"], \"destinations\": [\"Central Park, NY\"], \"mode\": \"driving\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent baidu-maps-sse/baidu-maps-sse maps_elevation '{\"locations\": [{\"latitude\": 36.057944, \"longitude\": -112.125168}]}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent baidu-maps-sse/baidu-maps-sse maps_directions '{\"origin\": \"Golden Gate Bridge\", \"destination\": \"Ferry Building San Francisco\", \"mode\": \"driving\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent brave-search/brave-search brave_web_search '{\"query\": \"latest AI research 2026\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent brave-search/brave-search brave_local_search '{\"query\": \"coffee near Times Square\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent google-search/google-search google_search '{\"query\": \"US inflation rate February 2026\", \"num\": 5, \"start\": 0}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_area_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_bar_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_boxplot_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_column_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_district_map '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_dual_axes_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_fishbone_diagram '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_flow_diagram '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_funnel_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_histogram_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_line_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_liquid_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_mind_map '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_network_graph '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_organization_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_path_map '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_pie_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_pin_map '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_radar_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_sankey_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_scatter_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_treemap_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_venn_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_violin_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_waterfall_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_word_cloud_chart '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent mcp-server-chart/mcp-server-chart generate_spreadsheet '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent tavily-remote-mcp/tavily-remote-mcp tavily_search '{\"query\": \"NVIDIA earnings\", \"max_results\": 5, \"search_depth\": \"advanced\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent tavily-remote-mcp/tavily-remote-mcp tavily_extract '{\"urls\": [\"https://example.com/article\"], \"extract_depth\": \"advanced\", \"format\": \"markdown\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent tavily-remote-mcp/tavily-remote-mcp tavily_crawl '{\"url\": \"https://example.com\", \"max_depth\": 1, \"max_breadth\": 10, \"limit\": 20}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent tavily-remote-mcp/tavily-remote-mcp tavily_map '{\"url\": \"https://example.com/docs\", \"max_depth\": 1, \"max_breadth\": 10, \"limit\": 30}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent tavily-remote-mcp/tavily-remote-mcp tavily_research '{\"input\": \"Impact of AI on healthcare\", \"model\": \"pro\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent google-maps/google-maps maps_geocode '{\"address\": \"Times Square, New York\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent google-maps/google-maps maps_reverse_geocode '{\"latitude\": 40.758, \"longitude\": -73.9855}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent google-maps/google-maps maps_search_places '{\"query\": \"Italian restaurants\", \"location\": {\"latitude\": 40.758, \"longitude\": -73.9855}, \"radius\": 500}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent google-maps/google-maps maps_place_details '{\"place_id\": \"ChIJmQJIxlVYwokRLgeuocVOGVU\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent google-maps/google-maps maps_distance_matrix '{\"origins\": [\"Times Square, NY\"], \"destinations\": [\"Central Park, NY\"], \"mode\": \"driving\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent google-maps/google-maps maps_elevation '{\"locations\": [{\"latitude\": 36.057944, \"longitude\": -112.125168}]}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent google-maps/google-maps maps_directions '{\"origin\": \"Golden Gate Bridge\", \"destination\": \"Ferry Building San Francisco\", \"mode\": \"driving\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_scrape '{\"url\": \"https://example.com/api-docs\", \"formats\": [\"json\"], \"onlyMainContent\": true}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_map '{\"query\": \"webhook\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_search '{\"query\": \"product pricing site:example.com\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_crawl '{\"url\": \"https://example.com\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_check_crawl_status '{\"crawl_id\": \"crawl-123\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_extract '{\"url\": \"https://example.com\", \"selector\": \"h1\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_agent '{\"task\": \"find pricing\", \"url\": \"https://example.com\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_agent_status '{\"job_id\": \"job-123\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_browser_create '{\"profile\": \"default\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_browser_execute '{\"browser_id\": \"browser-1\", \"script\": \"document.title\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_browser_delete '{\"browser_id\": \"browser-1\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent firecrawl-mcp/firecrawl-mcp firecrawl_browser_list '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent perplexity/perplexity perplexity_ask '{\"question\": \"Who won the 2024 World Series?\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent perplexity/perplexity perplexity_research '{\"query\": \"renewable energy policies US\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent perplexity/perplexity perplexity_reason '{\"topic\": \"impact of quantum computing\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent perplexity/perplexity perplexity_search '{\"query\": \"best VR headsets 2026\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github add_comment_to_pending_review '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github add_issue_comment '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github create_branch '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github create_or_update_file '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github create_pull_request '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github create_repository '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github delete_file '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github fork_repository '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github get_commit '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github get_file_contents '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github get_label '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github get_latest_release '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github get_me '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github get_release_by_tag '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github get_tag '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github get_team_members '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github get_teams '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github issue_read '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github issue_write '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github list_branches '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github list_commits '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github list_issue_types '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github list_issues '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github list_pull_requests '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github list_releases '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github list_tags '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github merge_pull_request '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github pull_request_read '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github pull_request_review_write '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github push_files '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github request_copilot_review '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github search_code '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github search_issues '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github search_pull_requests '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github search_repositories '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github search_users '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github sub_issue_write '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github update_pull_request '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent github/github update_pull_request_branch '{}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent gemini-nano-banana/gemini-nano-banana generate_image_gemini '{\"model\": \"gemini-2.5-flash-image\", \"prompt\": \"sunrise over mountains\", \"aspect_ratio\": \"16:9\", \"image_size\": \"1K\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent gemini-nano-banana/gemini-nano-banana generate_image_nano_banana '{\"model\": \"gemini-2.5-flash-image\", \"prompt\": \"robot reading book\", \"aspect_ratio\": \"16:9\", \"image_size\": \"1K\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent gemini-nano-banana/gemini-nano-banana generate_image_nano_banana_with_reference '{\"model\": \"gemini-3-pro-image-preview\", \"prompt\": \"winter coat style\", \"images\": [\"https://avatars.githubusercontent.com/u/242328252\"], \"aspect_ratio\": \"1:1\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent gemini-nano-banana/gemini-nano-banana ocr_extract_text_from_image '{\"images\": [\"https://avatars.githubusercontent.com/u/242328252\"], \"model\": \"gemini-3-flash-preview\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent gemini-nano-banana/gemini-nano-banana list_items_from_image '{\"images\": [\"https://avatars.githubusercontent.com/u/242328252\"], \"model\": \"gemini-3-flash-preview\", \"output_json\": true}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_direction_bicycling '{\"origin\": \"116.481028,39.989643\", \"destination\": \"116.465302,40.004717\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_direction_driving '{\"origin\": \"116.481028,39.989643\", \"destination\": \"116.465302,40.004717\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_direction_transit_integrated '{\"origin\": \"116.481028,39.989643\", \"destination\": \"116.465302,40.004717\", \"city\": \"北京\", \"cityd\": \"上海\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_direction_walking '{\"origin\": \"116.481028,39.989643\", \"destination\": \"116.465302,40.004717\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_distance '{\"origins\": \"116.481028,39.989643|116.465302,40.004717\", \"destination\": \"116.481028,39.989643\", \"type\": \"1\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_geo '{\"address\": \"Beijing Capital Airport\", \"city\": \"北京\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_regeocode '{\"location\": \"116.481488,39.990464\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_ip_location '{\"ip\": \"8.8.8.8\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_schema_personal_map '{\"orgName\": \"Weekend Trip\", \"lineList\": [{\"title\": \"Day1\", \"pointInfoList\": [{\"name\": \"Tiananmen\", \"lon\": 116.3975, \"lat\": 39.9087, \"poiId\": \"B000A8UIN8\"}]}]}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_around_search '{\"keywords\": \"coffee\", \"location\": \"116.481488,39.990464\", \"radius\": \"2000\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_search_detail '{\"id\": \"B0FFFABCD1\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_text_search '{\"keywords\": \"Tsinghua University\", \"city\": \"北京\", \"citylimit\": true}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_schema_navi '{\"lon\": \"116.3975\", \"lat\": \"39.9087\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_schema_take_taxi '{\"slon\": \"116.3975\", \"slat\": \"39.9087\", \"sname\": \"Tiananmen\", \"dlon\": \"116.481028\", \"dlat\": \"39.989643\", \"dname\": \"Sanlitun\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
+      },
+      {
+        "cli": "onekey agent amap-maps-streamableHTTP/amap-maps-streamableHTTP maps_weather '{\"city\": \"北京\"}'",
+        "hint": "Invoke a specific agent by ID with structured JSON data or a file input"
       }
     ]
   },
-"openai/codex-cli": {
+  "openai/codex-cli": {
     "hints": [
       {
         "cli": "codex",

package/dist/agtm-cli.js

@@ -458,7 +458,7 @@ async function handleSkillsAdd(options) {
         process.exit(1);
         return;
     }
-    console.log("INFO: Staring to fetch skills...");
+    console.log("INFO: Starting to fetch skills...");
     const resolved = resolveSkillSource(source);
     const skills = discoverSkills(resolved.root);
     if (skills.length === 0) {
@@ -1214,10 +1214,53 @@ function loadCombinedHints(useGlobal) {
 function buildIdTrie(hints) {
     const trie = createTrie();
     for (const id of Object.keys(hints)) {
-        insertTrie(trie, id, id);
+        for (let i = 0; i < id.length; i++) {
+            insertTrie(trie, id.substring(i), id);
+        }
     }
     return trie;
 }
+function buildInvertedIndex(hints) {
+    const index = {};
+    for (const [id, entry] of Object.entries(hints)) {
+        if (!entry.hints)
+            continue;
+        for (const item of entry.hints) {
+            const doc = { id, cli: item.cli, hint: item.hint || '' };
+            const text = `${id} ${item.cli} ${item.hint || ''}`.toLowerCase();
+            const tokens = Array.from(new Set(text.split(/[^a-z0-9]+/)));
+            for (const token of tokens) {
+                if (!token)
+                    continue;
+                if (!index[token])
+                    index[token] = [];
+                if (!index[token].some(d => d.id === doc.id && d.cli === doc.cli)) {
+                    index[token].push(doc);
+                }
+            }
+        }
+    }
+    return index;
+}
+function searchInvertedIndex(index, query) {
+    const tokens = query.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
+    if (tokens.length === 0)
+        return [];
+    let results = new Map();
+    for (const [key, docs] of Object.entries(index)) {
+        for (const token of tokens) {
+            if (key.includes(token)) {
+                for (const doc of docs) {
+                    const docKey = `${doc.id}::${doc.cli}`;
+                    if (!results.has(docKey)) {
+                        results.set(docKey, doc);
+                    }
+                }
+            }
+        }
+    }
+    return Array.from(results.values());
+}
 function buildCliTrie(hints) {
     const trie = createTrie();
     for (const item of hints) {
@@ -1233,9 +1276,19 @@ function filterCliHints(hints, query, limit) {
     }
     const trimmed = query.trim().toLowerCase();
     if (trimmed) {
-        const scored = hints
-            .map((item) => ({ item, score: fuzzyScore(trimmed, item.cli) }))
-            .filter((entry) => entry.score > 0);
+        const queryTokens = Array.from(new Set(trimmed.split(/[^a-z0-9]+/))).filter(Boolean);
+        const scored = hints.map((item) => {
+            const text = `${item.cli} ${item.hint || ''}`.toLowerCase();
+            let tokenMatches = 0;
+            for (const token of queryTokens) {
+                if (text.includes(token)) {
+                    tokenMatches += 1;
+                }
+            }
+            const fScore = fuzzyScore(trimmed, item.cli);
+            const score = tokenMatches * 10 + fScore;
+            return { item, score };
+        }).filter((entry) => entry.score > 0);
         scored.sort((a, b) => b.score - a.score || a.item.cli.localeCompare(b.item.cli));
         return scored.slice(0, limit).map((entry) => entry.item);
     }
@@ -1358,14 +1411,35 @@ async function selectSkillId(hints, input, limit = 5, trie) {
     }
     const activeTrie = trie || buildIdTrie(hints);
     const prefix = input || '';
-    let suggestions = searchTrie(activeTrie, prefix, limit);
-    if (suggestions.length === 0 && prefix) {
+    let trieSuggestions = searchTrie(activeTrie, prefix, limit);
+    let hintMatches = new Set();
+    let finalSuggestions = [];
+    if (prefix) {
+        const index = buildInvertedIndex(hints);
+        const docs = searchInvertedIndex(index, prefix);
+        const scoredDocs = new Map();
+        for (const doc of docs) {
+            scoredDocs.set(doc.id, (scoredDocs.get(doc.id) || 0) + 1);
+        }
+        const sortedDocs = Array.from(scoredDocs.entries()).sort((a, b) => b[1] - a[1]);
+        for (const [id] of sortedDocs) {
+            finalSuggestions.push(id);
+            hintMatches.add(id);
+        }
+    }
+    for (const id of trieSuggestions) {
+        if (!finalSuggestions.includes(id)) {
+            finalSuggestions.push(id);
+        }
+    }
+    if (finalSuggestions.length === 0 && prefix) {
         const scored = ids
             .map((id) => ({ id, score: fuzzyScore(prefix, id) }))
             .filter((entry) => entry.score > 0);
         scored.sort((a, b) => b.score - a.score || a.id.localeCompare(b.id));
-        suggestions = scored.slice(0, limit).map((entry) => entry.id);
+        finalSuggestions = scored.slice(0, limit).map((entry) => entry.id);
     }
+    let suggestions = finalSuggestions.slice(0, limit);
     if (suggestions.length === 0) {
         return null;
     }
@@ -1377,7 +1451,8 @@ async function selectSkillId(hints, input, limit = 5, trie) {
     trackedLog('');
     trackedLog('Skill ID suggestions:');
     suggestions.forEach((value, index) => {
-        trackedLog(`  ${index + 1}. ${highlightMatches(value, prefix)}`);
+        const hintBadge = hintMatches.has(value) ? ', \x1b[32m[hints]\x1b[0m' : '';
+        trackedLog(`  ${index + 1}. ${highlightMatches(value, prefix)}${hintBadge}`);
     });
     const selected = await promptSelection('Select skill id (number or id): ', suggestions);
     printedLines += 1; // prompt line
@@ -1491,8 +1566,28 @@ function countConsoleLogLines(message) {
         return 1;
     return message.split('\n').length;
 }
+/**
+ If input json is single quoted already, don't double quote
+ '{"a":1}': unchanged
+ "{"a":1}": unchanged
+ {"a":1}: '{"a":1}'
+ */
+function safelyQuoteArgs(cmd) {
+    return cmd.replace(/(['"])?({[^{}]*})(['"])?/g, (match, open, json, close) => {
+        // already quoted properly → keep as-is
+        if (open && close && open === close) {
+            return match;
+        }
+        // wrap ONLY the JSON part
+        return `'${json.replace(/'/g, `'\\''`)}'`;
+    });
+}
+/**
+ Usage: agtm run <unique_id> <cli>
+ */
 async function handleRun(idArg, commandArgs = [], options = {}) {
     const isAgent = (options.mode || 'human').toLowerCase() === MODE_AGENT;
+    const originalIdArg = idArg;
     // first load local hints
     // 1. Install Local and Global Cache
     let hints = loadCombinedHints(false);
@@ -1527,17 +1622,41 @@ async function handleRun(idArg, commandArgs = [], options = {}) {
         if (!idArg || !activeHints[idArg]) {
             const query = idArg || '';
             const trie = cachedIdTrie || buildIdTrie(activeHints);
-            let suggestions = searchTrie(trie, query, 2);
-            if (suggestions.length === 0 && query) {
+            let trieSuggestions = searchTrie(trie, query, 5);
+            let hintMatches = new Set();
+            let finalSuggestions = [];
+            if (query) {
+                const index = buildInvertedIndex(activeHints);
+                const docs = searchInvertedIndex(index, query);
+                const scoredDocs = new Map();
+                for (const doc of docs) {
+                    scoredDocs.set(doc.id, (scoredDocs.get(doc.id) || 0) + 1);
+                }
+                const sortedDocs = Array.from(scoredDocs.entries()).sort((a, b) => b[1] - a[1]);
+                for (const [id] of sortedDocs) {
+                    finalSuggestions.push(id);
+                    hintMatches.add(id);
+                }
+            }
+            for (const id of trieSuggestions) {
+                if (!finalSuggestions.includes(id)) {
+                    finalSuggestions.push(id);
+                }
+            }
+            if (finalSuggestions.length === 0 && query) {
                 const scored = ids
                     .map((id) => ({ id, score: fuzzyScore(query, id) }))
                     .filter((entry) => entry.score > 0);
                 scored.sort((a, b) => b.score - a.score || a.id.localeCompare(b.id));
-                suggestions = scored.slice(0, 2).map((entry) => entry.id);
+                finalSuggestions = scored.slice(0, 5).map((entry) => entry.id);
             }
+            let suggestions = finalSuggestions.slice(0, 5);
+            // In agent mode, if we have a very strong single match, we might want to use it.
+            // But for now, let's just print suggestions and exit as before, but with better ranking.
             console.log('\nSkill ID suggestions:');
             suggestions.forEach((value, index) => {
-                console.log(`  ${index + 1}. ${highlightMatches(value, query)}`);
+                const hintBadge = hintMatches.has(value) ? ', \x1b[32m[hints]\x1b[0m' : '';
+                console.log(`  ${index + 1}. ${highlightMatches(value, query)}${hintBadge}`);
                 const entry = activeHints[value];
                 if (entry?.hints?.length) {
                     const preview = entry.hints.slice(0, 2).map((h) => `${h.cli}${h.hint ? ` # ${h.hint}` : ''}`);
@@ -1547,6 +1666,7 @@ async function handleRun(idArg, commandArgs = [], options = {}) {
             process.exit(1);
         }
         let finalCommandArgs = commandArgs;
+        // Adjust idArg and finalCommandArgs if necessary
         if (finalCommandArgs.length > 0 && activeHints[finalCommandArgs[0]]) {
             idArg = finalCommandArgs[0];
             finalCommandArgs = finalCommandArgs.slice(1);
@@ -1557,7 +1677,10 @@ async function handleRun(idArg, commandArgs = [], options = {}) {
         const hintEntry = activeHints[idArg];
         if (!finalCommandArgs || finalCommandArgs.length === 0) {
             console.log('\nCommand hints:');
-            hintEntry?.hints?.slice(0, 5).forEach((item, index) => {
+            // USE originalIdArg to filter hints even in agent mode if no command specified
+            const searchQuery = (originalIdArg && originalIdArg !== idArg) ? originalIdArg : '';
+            const suggestions = filterCliHints(hintEntry.hints || [], searchQuery, 5);
+            suggestions.forEach((item, index) => {
                 const hintText = item.hint ? ` # ${item.hint}` : '';
                 console.log(`  ${index + 1}. ${item.cli}${hintText}`);
             });
@@ -1643,7 +1766,8 @@ async function handleRun(idArg, commandArgs = [], options = {}) {
         if (!finalCommandArgs || finalCommandArgs.length === 0) {
             let chosen = null;
             if (hintEntry?.hints && hintEntry.hints.length > 0) {
-                const query = await promptCommandLine(`\nEnter command to run (leave empty to list cli hints): `, ``);
+                const defaultQuery = (originalIdArg && originalIdArg !== idArg) ? originalIdArg : '';
+                const query = await promptCommandLine(`\nEnter command to run (leave empty to list cli hints): `, defaultQuery);
                 const searchQuery = query || '';
                 chosen = await selectCliHint(hintEntry.hints, searchQuery);
             }
@@ -1670,19 +1794,32 @@ async function handleRun(idArg, commandArgs = [], options = {}) {
             console.error('\n❌ Error: Missing command to run.');
             process.exit(1);
         }
-        const finalCommandLine = finalCommandArgs.join(' ');
+        let finalCommandLine = finalCommandArgs.join(' ');
         console.log("\nComplete the Cli with your arguments or leave blank and press Enter");
         const edited = await promptCommandLine(`\nFinal command line [${finalCommandLine}]:\n`, `${finalCommandLine}`);
+        //         if (edited && edited.trim()) {
+        //             finalCommandArgs = edited.split(/\s+/).filter(Boolean);
+        //         }
+        // IMPORTANT: do NOT split anymore, keep the json in <cli> not split again agtm run <id> <cli>
         if (edited && edited.trim()) {
-            finalCommandArgs = edited.split(/\s+/).filter(Boolean);
+            finalCommandLine = edited.trim();
         }
+        // re-add quotes for JSON
+        finalCommandLine = safelyQuoteArgs(finalCommandLine);
         const [command, ...args] = finalCommandArgs;
-        const printable = `agtm run ${idArg} ${finalCommandArgs.join(' ')}`.trim();
+        const printable = `agtm run ${idArg} ${finalCommandLine}`.trim();
         console.log(`\u001b[32m${printable}\u001b[0m`);
         if (options.print || options.dryRun) {
             return;
         }
-        const child = spawn(command, args, { stdio: 'inherit' });
+        if (LOG_ENABLE) {
+            console.log(`finalCommandLine is ${finalCommandLine}`);
+        }
+        const child = spawn(finalCommandLine, {
+            stdio: 'inherit',
+            shell: true
+        });
+        // const child = spawn(command, args, { stdio: 'inherit' });
         child.on('error', (err) => {
             if (err.code === 'ENOENT') {
                 console.error(`\n❌ Error: Command not found: ${command}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiagenta2z/agtm",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "agtm: CLI Tool for AI Agent Management, Skills, Agent Registry, Benchmarks and Hints in AI Agent Marketplace\n",
   "main": "dist/agtm-cli.js",
   "type": "module",