@aiagenta2z/agtm 1.0.7 → 1.0.8

package/dist/test/skills.spec.js

@@ -0,0 +1,93 @@
+import { spawnSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const projectRoot = path.resolve(__dirname, '..');
+const cliPath = path.join(projectRoot, 'agtm-cli.ts');
+function runCli(args, env = {}) {
+    const result = spawnSync('node', ['--loader', 'ts-node/esm', cliPath, ...args], {
+        cwd: projectRoot,
+        env: { ...process.env, ...env },
+        encoding: 'utf8'
+    });
+    return result;
+}
+function assertExitZero(result, label) {
+    if (result.status !== 0) {
+        throw new Error(`${label} failed with code ${result.status}:\n${result.stdout}\n${result.stderr}`);
+    }
+}
+function ensureSkillDirs() {
+    const skills = [
+        '.agents/skills/code_success_skills',
+        '.agents/skills/code_fail_skills',
+        '.agents/skills/agtm_agent_management_skill'
+    ];
+    for (const rel of skills) {
+        const full = path.join(projectRoot, rel);
+        if (!fs.existsSync(full)) {
+            fs.mkdirSync(full, { recursive: true });
+        }
+    }
+}
+function main() {
+    ensureSkillDirs();
+    const logDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agtm-log-'));
+    // Log runs (no rating/level at this stage)
+    let res = runCli(['skills', 'log', 'code_success_skills', '--data', JSON.stringify({ input: 'success-1', output: 'out-1' }), '-d', logDir]);
+    assertExitZero(res, 'log success #1');
+    res = runCli(['skills', 'log', 'code_success_skills', '--data', JSON.stringify({ input: 'success-2', output: 'out-2' }), '-d', logDir]);
+    assertExitZero(res, 'log success #2');
+    res = runCli(['skills', 'log', 'code_fail_skills', '--data', JSON.stringify({ input: 'fail-1', output: 'out-fail' }), '-d', logDir]);
+    assertExitZero(res, 'log failure');
+    // Prepare evaluation payload for successes
+    res = runCli(['skills', 'rate', 'prepare', '--skill_id', 'code_success_skills', '-d', logDir]);
+    assertExitZero(res, 'rate prepare success');
+    const payload = JSON.parse(res.stdout);
+    if (!Array.isArray(payload.logs) || payload.logs.length !== 2) {
+        throw new Error('Prepare payload missing expected logs for success skill');
+    }
+    if (!Array.isArray(payload.benchmarks) || payload.benchmarks.length === 0) {
+        throw new Error('Prepare payload missing benchmarks array');
+    }
+    const successResults = {
+        results: payload.logs.map((log) => ({
+            log_id: log.log_id,
+            rating: 1,
+            level: 'L4'
+        }))
+    };
+    res = runCli(['skills', 'rate', 'apply', '--skill_id', 'code_success_skills', '--result', JSON.stringify(successResults), '-d', logDir]);
+    assertExitZero(res, 'rate apply success');
+    // Apply results for fail skill
+    const failEntry = fs.readdirSync(logDir)
+        .map((f) => path.join(logDir, f))
+        .map((p) => JSON.parse(fs.readFileSync(p, 'utf8')))
+        .find((e) => e.skill_id === 'code_fail_skills');
+    const failResults = { results: [{ log_id: failEntry.log_id, rating: 0, level: 'L3' }] };
+    res = runCli(['skills', 'rate', 'apply', '--skill_id', 'code_fail_skills', '--result', JSON.stringify(failResults), '-d', logDir]);
+    assertExitZero(res, 'rate apply fail');
+    // Show aggregated table for success skill
+    res = runCli(['skills', 'rate', 'show', '--skill_id', 'code_success_skills', '-d', logDir]);
+    assertExitZero(res, 'rate show success');
+    const table = res.stdout.trim();
+    const cleanTable = table.replace(/\x1b\[[0-9;]*m/g, '');
+    if (!/code_success_skills\s+2\s+1\.00\s+L4/.test(cleanTable)) {
+        throw new Error(`Unexpected rate show output for success skill:\n${cleanTable}`);
+    }
+    // Verify persisted ratings/levels
+    const saved = fs.readdirSync(logDir).map((f) => JSON.parse(fs.readFileSync(path.join(logDir, f), 'utf8')));
+    const successSaved = saved.filter((e) => e.skill_id === 'code_success_skills');
+    const failSaved = saved.find((e) => e.skill_id === 'code_fail_skills');
+    if (successSaved.some((e) => e.rating !== 1 || e.level !== 'L4')) {
+        throw new Error('Success logs missing applied rating/level');
+    }
+    if (!failSaved || failSaved.rating !== 0 || failSaved.level !== 'L3') {
+        throw new Error('Fail log missing applied rating/level');
+    }
+    console.log('Skills log/rate prepare/apply integration test passed.');
+}
+main();

package/docs/registry/README.md

@@ -0,0 +1,239 @@
+### Agtm AI Agent Registry CLI Usage
+
+Agtm provides AI Agent registry service, including cli to help register your AI Agent meta data, search relevant AI agent information by "id" or "query". 
+
+### `search`
+`agtm search` helps to search AI Agent MCP and skills marketplace by id or query keywords.
+
+Example Usage
+```shell
+agtm search --q 'coding agent'
+agtm search --id 'google-maps/google-maps'
+```
+
+### `upload`
+`agtm update` helps to update your local agent.json or agent.yaml meta information to DeepNLP AI Agent Marketplace Index.
+Example Usage
+```shell
+agtm upload --github https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent
+agtm upload --config ./agent.json
+agtm upload --config ./agent.yaml
+```
+
+## Tutorial 
+
+###  1. Installation
+
+**Node**
+``` NodeJS
+npm install -g @aiagenta2z/agtm
+```
+
+note: run nodejs environment, you need to add -g to install, so you can just run command line `agtm` without the `npx agtm` prefix,
+
+Command line to register your AI agent from GitHub, Local config(agent.json, agent.yaml) or search the AI agent marketplace.
+To see detailed usage, visit the GitHub of `agtm` at Documentation (https://github.com/aiagenta2z/ai-agent-marketplace)
+
+**Python**
+```
+pip install ai-agent-marketplace
+```
+
+The cli bin will be copied to python path. Future version, only 'node' command line will be supported.
+
+### Setup
+Let's say you have create a repo of your open source AI Agent (e.g. https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent), And you want to 
+register and get a registered detailed page of AI Agent in the marketplace and monitor the traffic.
+
+**Setup Access Key**
+
+First you need to setup an access_key in the environment to authenticate.
+Register your AI Agent Marketplace [Access Key here](https://deepnlp.org/workspace/keys)
+
+```
+export AI_AGENT_MARKETPLACE_ACCESS_KEY="{your_access_key}"
+```
+
+You can also use the test key for validation, which is associated with a test-only account on deepnlp.org and aiagenta2z.com. 
+
+```
+export AI_AGENT_MARKETPLACE_ACCESS_KEY="TEST_KEY_AI_AGENT_REGISTRY"
+```
+
+### 3. AI Agent Registry
+
+**Registry AI Agent from your GitHub**
+
+The default registry provider endpoint includes: [DeepNLP AI Agent Registry Endpoint](https://www.deepnlp.org/api/ai_agent_marketplace/registry) | 
+[aiagenta2z.com Registry Endpoint](https://www.aiagenta2z.com/api/ai_agent_marketplace/registry)|[aiagenta2z.org Registry Endpoint](https://www.aiagenta2z.org/api/ai_agent_marketplace/registry), etc. 
+
+You can also set your customized registry endpoint via `--endpoint` parameter
+
+
+```
+agtm upload --github https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent
+```
+
+
+**Registry AI Agent from agent.json or agent.yaml file**
+
+
+```
+
+## Register from local config of AI Agent meta
+agtm upload --config ./agent.json
+agtm upload --config ./agent.yaml
+```
+
+You can download sample [agent.json](https://github.com/aiagenta2z/agtm/blob/main/agent.json) or [agent.yaml](https://github.com/aiagenta2z/agtm/blob/main/agent.yaml) file from github https://github.com/aiagenta2z/agtm
+See the explanation of the schema, please visit the [documentation](https://www.deepnlp.org/doc/ai_agent_marketplace).
+
+
+Demo agent.json file
+```
+{
+    "name": "My First AI Coding Agent",
+    "content": "This AI Agent can do complicated programming work for humans",
+    "website": "https://www.my_first_agent.com",
+    "field": "AI AGENT",
+    "subfield": "Coding Agent",
+    "content_tag_list": "coding,python",
+    "github": "",
+    "thumbnail_picture": "https://avatars.githubusercontent.com/u/242328252?s=200&v=4",
+    "upload_image_files": "",
+    "api": "https://www.my_first_agent.com/agent",
+    "price_type": "PER_CALL",
+    "price_per_call_credit": 0.0,
+    "price_fixed_credit" : 0.0,
+    "price_subscription": "Basic: your basic plan introduction, Advanced: Your Advanced Plan introduction, etc."
+}
+```
+Demo agent.yaml file
+```
+
+name: "My First AI Coding Agent"
+content: "This AI Agent can do complicated programming work for humans"
+website: "https://www.my_first_agent.com"
+field: "AI AGENT"
+subfield: "Coding Agent"
+content_tag_list: "coding,python"
+github: "https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent"
+thumbnail_picture: "https://avatars.githubusercontent.com/u/242328252?s=200&v=4"
+upload_image_files: ""
+api: "https://www.my_first_agent.com/agent"
+price_type: "API Call"
+price_per_call_credit: 0.0
+price_fixed_credit: 0.0
+price_subscription: "Basic: your basic plan introduction, Advanced: Your Advanced Plan introduction, etc."
+
+```
+
+**Use your customized endpoint and schema definition**
+
+You have the flexibility to use the AI Agent marketplace/manager cli `agtm` to submit customized ai agent schema to your customized endpoint.
+
+You need to define a customized `schema.json` (https://github.com/aiagenta2z/agtm/blob/main/schema.json) file similar to the default one below and your URL of `endpoint`.
+Then the package will POST the the data schema to your endpoint. 
+
+
+Note: the keys in agent.json and schema.json should match. Package will select keys from the agent.json/agent.yaml files.
+
+
+`schema.json` should have two keys defined the required fields and optional fields you want to submit from the agent.json file. 
+
+Remember to keep the `access_key` in safe place, the post request will post the `access_key` as well as schema to the endpoint. 
+
+#### default schema.json definition
+```
+{
+    "required": [
+        "name",
+        "content"
+    ],
+    "optional": [
+        "website", 
+        "field", 
+        "subfield", 
+        "content_tag_list", 
+        "github", 
+        "price_type", 
+        "api", 
+        "thumbnail_picture", 
+        "upload_image_files",
+        "sdk",
+        "package"
+    ]
+}
+```
+
+
+Please visit the command line github package [agtm](https://github.com/aiagenta2z/agtm) and [DOC](https://www.deepnlp.org/doc/ai_agent_marketplace) detailed usage.
+
+
+Use the test account and access 
+
+```
+export AI_AGENT_MARKETPLACE_ACCESS_KEY="TEST_KEY_AI_AGENT_REGISTRY"
+
+agtm upload --config ./agent.json --endpoint https://www.deepnlp.org/api/ai_agent_marketplace/registry --schema ./schema.json
+
+agtm upload --config ./agent.json --endpoint https://www.aiagenta2z.com/api/ai_agent_marketplace/registry --schema ./schema.json
+```
+
+
+```
+Setting Registry Endpoint to URL: https://www.deepnlp.org/api/ai_agent_marketplace/registry
+Customized Schema is enabled : ./schema.json
+Attempting to register agent from config file: ./agent.json
+✅ Loaded custom schema from: ./schema.json
+Using customized schema {"required": ["name", "content"], "optional": ["website", "field", "subfield", "content_tag_list", "github", "price_type", "api", "thumbnail_picture", "upload_image_files", "sdk", "package"]}
+WARN: Calling AddServiceAPI input param optional keys filled fields ['website', 'field', 'subfield', 'content_tag_list', 'github', 'price_type', 'api', 'thumbnail_picture', 'upload_image_files']|missing_fields []
+Submitting agent information to the marketplace...
+
+✅ Registration Successful!
+   URL: https://www.deepnlp.org/store/ai-agent/coding-agent/pub-test-agtm-registry/my-first-ai-coding-agent
+   Message: Content Updated Successfully|Visit URL at https://www.deepnlp.org/store/ai-agent/coding-agent/pub-test-agtm-registry/my-first-ai-coding-agent and Login to View the Pending status webpage...
+   Track its status at: https://www.deepnlp.org/store/ai-agent/coding-agent/pub-test-agtm-registry/my-first-ai-coding-agent
+```
+
+
+Use www.example.com as endpoint example 
+
+
+```
+agtm upload --config ./agent.json --endpoint https://www.example.com --schema ./schema.json
+
+```
+
+It will return an error message showing the endpoint and data, https://www.example.com doesn't have endpoint handling
+
+```
+❌ Registration Failed. Please check your endpoint https://www.example.com  and agent data {'name': 'My First AI Coding Agent', 'content': 'This AI Agent can do complicated programming work for humans', 'website': 'https://www.my_first_agent.com', 'field': 'AI AGENT', 'subfield': 'Coding Agent', 'content_tag_list': 'coding,python', 'github': '', 'thumbnail_picture': 'https://avatars.githubusercontent.com/u/242328252?s=200&v=4', 'upload_image_files': '', 'api': 'https://www.my_first_agent.com/agent', 'price_type': 'FREE', 'price_per_call_credit': 0.0, 'price_fixed_credit': 0.0, 'price_subscription': 'Basic: your basic plan introduction, Advanced: Your Advanced Plan introduction, etc.'}
+```
+
+
+**Search AI Agent Marketplace**
+
+```
+
+## Search Open Source AI Agent marketplace of deepnlp
+
+agtm search --q 'coding agent'
+agtm search --id 'google-maps/google-maps'
+agtm search --id 'AI-Hub-Admin/My-First-AI-Coding-Agent'
+```
+
+Search Result of query q="coding agent"
+
+```
+[{'content_name': 'Cursor AI', 'publisher_id': 'pub-cursor', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-cursor/cursor-ai', 'website': 'https://docs.cursor.com/agent', 'github': '', 'review_cnt': '3', 'rating': '3.3', 'description': 'Cursor AI Coding Editor provides Agent mode, which is the default mode in Cursor, equipped with all tools to efficiently handle a wide range of coding tasks. Agent is the default mode in Cursor that is best for most tasks. It has all tools enabled to allow it to perform all operations necessary to complete the task at hand. Make sure to read chat overview to learn more about how modes work in Curs', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'cursor/cursor-ai', 'content_tag_list': 'Coding Agent,AI AGENT', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/a7dd95e7eb419437ef4a91f4b0e853cb.jpg'}, {'content_name': 'trae ai', 'publisher_id': 'pub-trae-ai', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-trae-ai/trae-ai', 'website': 'https://www.trae.ai/', 'github': '', 'review_cnt': '2', 'rating': '4.0', 'description': 'Trae AI IDE is a cutting-edge AI-integrated development environment designed to enhance developer productivity by leveraging advanced AI models like Claude3.5 and GPT-4o. It offers a seamless coding experience with features such as intelligent code generation, real-time feedback, and multi-modal input support, making it a powerful tool for developers. Introduction Trae AI IDE, developed by ByteDan', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'trae-ai/trae-ai', 'content_tag_list': 'CODING AGENT,AI AGENT', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/cc43d2dc25488b50b883781e0ae8c988.png'}, {'content_name': 'codex', 'publisher_id': 'pub-openai', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-openai/codex', 'website': 'https://github.com/openai/codex', 'github': 'https://github.com/openai/codex', 'review_cnt': '1', 'rating': '5.0', 'description': 'npm i -g @openai/codexor brew install --cask codex\n\nCodex CLI is a coding agent from OpenAI that runs locally on your computer.\n\nIf you want Codex in your code editor (VS Code, Cursor, Windsurf), install in your IDE\nIf you are looking for the cloud-based agent from OpenAI, Codex Web, go to chatgpt.com/codex\n\n\n  \n  \n\n---\n\n## Quickstart\n\n### Installing and running Codex CLI\n\nInstall globally with yo', 'subfield': 'CODING AGENT', 'field': 'AI AGENT', 'id': 'openai/codex', 'content_tag_list': 'GitHub 48.6k', 'thumbnail_picture': 'https://avatars.githubusercontent.com/u/14957082?v=4'}, {'content_name': 'fine dev', 'publisher_id': 'pub-fine-dev', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/ai-agent/pub-fine-dev/fine-dev', 'website': 'https://www.fine.dev', 'github': '', 'review_cnt': '1', 'rating': '4.0', 'description': 'Full-Stack AI Developer Agent for Startups Accelerate your startup’s release schedule and ship daily improvements. Fine is the AI Coding Agent built to act like another team member, getting work done. Try free or watch it work.', 'subfield': 'AI AGENT', 'field': 'AI AGENT', 'id': 'fine-dev/fine-dev', 'content_tag_list': ',AI AGENT', 'thumbnail_picture': 'https://www.fine.dev/_next/static/media/logo.76f79362.svg'}, {'content_name': 'claude code', 'publisher_id': 'pub-claude-code', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-claude-code/claude-code', 'website': 'https://www.anthropic.com/claude-code', 'github': '', 'review_cnt': '1', 'rating': '5.0', 'description': 'Claude Code by Anthropic is an AI-powered coding assistant designed to enhance developer productivity by providing intelligent code generation, debugging, and optimization capabilities. It integrates seamlessly with various developer tools, making it easy to use within existing workflows. Introduction Claude Code is a powerful AI coding assistant developed by Anthropic, aimed at helping developers', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'claude-code/claude-code', 'content_tag_list': 'CODING AGENT,AI AGENT', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/7d6c735321396b42b5c2e46499e17a6e.png'}, {'content_name': 'qwen code', 'publisher_id': 'pub-qwen-code', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-qwen-code/qwen-code', 'website': '', 'github': '', 'review_cnt': '1', 'rating': '4.0', 'description': 'Qwen Coding Agent offers an advanced framework for developing applications utilizing large language models (LLMs), enhancing capabilities such as instruction following, tool usage, planning, and memory. Introduction Qwen Coding Agent provides a robust platform for building LLM applications, leveraging the advanced features of Qwen models (version 2.0 and above). It facilitates the development of i', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'qwen-code/qwen-code', 'content_tag_list': ',AI AGENT', 'thumbnail_picture': 'https://camo.githubusercontent.com/db544c14e8419ecf289564a79841e005c518fc29cd418ac4a31215e9377eaa22/68747470733a2f2f7169616e77656e2d7265732e6f73732d636e2d6265696a696e672e616c6979756e63732e636f6d2f5177656e322e352f5177656e322e352d436f6465722f7177656e322e352d636f6465722d6c6f676f'}, {'content_name': 'Qoder', 'publisher_id': 'pub-qoder', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-qoder/qoder', 'website': 'https://qoder.com/download', 'github': '', 'review_cnt': '1', 'rating': '5.0', 'description': '\r\n## Qoder\r\n\r\nQoder is an agentic coding platform designed for real software development. It seamlessly integrates enhanced context engineering with intelligent agents to gain a comprehensive understanding of your codebase and systematically tackles software development tasks.\r\nIt goes beyond simple code completion-Qoder helps you think deeper, code smarter, and build better by automating intricat', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'qoder/qoder', 'content_tag_list': 'coding,agent', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/6d7c68c43f520b76251fe2ac7c0061a8.jpg'}, {'content_name': 'CodeBuddy IDE Tencent', 'publisher_id': 'pub-tencent', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-tencent/codebuddy-ide-tencent', 'website': 'https://copilot.tencent.com/ide', 'github': '', 'review_cnt': '1', 'rating': '4.0', 'description': '\r\nCodeBuddy IDE Tencent AI 一站式工作台：从此用自然语言实现产品、设计、研发全流程\r\n\r\n\r\n\r\n## AI 智能代码补全\r\n所想即所码\r\nAI驱动的实时代码预测与智能补全，让编程如行云流水\r\n\r\n\r\n## AI 设计生成\r\n草图秒变原型\r\n手绘概念瞬间转化为高保真交互原型，创意无需等待\r\n\r\n## 设计稿转代码\r\n一稿生万码\r\nFigma设计 稿一键转换为生产级代码，还原度高达99.9%\r\n\r\n\r\n## AI 全栈开发\r\n你的AI编程搭档\r\n智能开发代理，自主完成多文件代码生成与重构\r\n\r\n\r\n## 内置后端服务\r\n后端开 发零门槛\r\n内置腾讯云 CloudBase 和 Supabase服务，数据库与用户认证一键搞定\r\n\r\n## 一键部署分享\r\n开发、部署、分享，一键搞定\r\n内置 Cloud Studio，EdgeOne Pages，从开发环境到在线演示，只需一秒钟', 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'tencent/codebuddy-ide-tencent', 'content_tag_list': 'ide,coding agent', 'thumbnail_picture': 'https://static.aiagenta2z.com/scripts/img/ai_service_content/3ef7d0e02ecbf36eb9dbd25590c7c87e.jpg'}, {'content_name': 'zencoder ai', 'publisher_id': 'pub-zencoder-ai', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/coding-agent/pub-zencoder-ai/zencoder-ai', 'website': 'https://zencoder.ai', 'github': '', 'review_cnt': '0', 'rating': '0.0', 'description': "Zencoder AI provides a range of AI agents designed to streamline and enhance various business processes through intelligent automation and advanced AI capabilities. Introduction Zencoder AI's AI agents are built to act as digital assistants, automating complex tasks and improving operational efficiency across multiple industries. These agents leverage cutting-edge AI technologies to handle tasks s", 'subfield': 'Coding Agent', 'field': 'AI AGENT', 'id': 'zencoder-ai/zencoder-ai', 'content_tag_list': ',AI AGENT', 'thumbnail_picture': 'https://zencoder.ai/favicon.ico'}, {'content_name': 'gpt-engineer', 'publisher_id': 'pub-antonosika', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/ai-agent/pub-antonosika/gpt-engineer', 'website': 'https://github.com/AntonOsika/gpt-engineer', 'github': 'https://github.com/AntonOsika/gpt-engineer', 'review_cnt': '0', 'rating': '0.0', 'description': '# gpt-engineer\n\n](https://github.com/gpt-engineer-org/gpt-engineer)\n](https://discord.gg/8tcDQ89Ej2)\n](https://github.com/gpt-engineer-org/gpt-engineer/blob/main/LICENSE)\n](https://github.com/gpt-engineer-org/gpt-engineer/issues)\n\n](https://twitter.com/antonosika)\n\nThe OG code genereation experimentation platform!\n\nIf you are looking for the evolution that is an opinionated, managed service – chec', 'subfield': 'AI AGENT', 'field': 'AI AGENT', 'id': 'antonosika/gpt-engineer', 'content_tag_list': 'GitHub 55.0k,ai,autonomous-agent,code-generation,codebase-generation,codegen,coding-assistant,gpt-4,gpt-engineer,openai,python', 'thumbnail_picture': 'https://avatars.githubusercontent.com/u/4467025?v=4'}]
+```
+
+Search Result of Retrieving registered project id 'AI-Hub-Admin/My-First-AI-Coding-Agent'
+
+```
+Retrieving specific agent with unique ID: AI-Hub-Admin/My-First-AI-Coding-Agent
+
+{'total_hits': 1, 'id': 'AI-Hub-Admin/My-First-AI-Coding-Agent', 'items': [{'content_name': 'My-First-AI-Coding-Agent', 'publisher_id': 'pub-ai-hub-admin', 'detail_url': 'https://www.deepnlp.org/store/ai-agent/ai-agent/pub-ai-hub-admin/my-first-ai-coding-agent', 'website': 'https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent', 'github': 'https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent', 'review_cnt': '0', 'rating': '0.0', 'description': '# My-First-AI-Coding-Agent\nAI Agent Registry Demo project\n\n', 'subfield': 'AI AGENT', 'field': 'AI AGENT', 'id': 'ai-hub-admin/my-first-ai-coding-agent', 'content_tag_list': 'GitHub 0', 'thumbnail_picture': 'https://avatars.githubusercontent.com/u/184629057?v=4'}]}
+```
+

package/docs/run/README.md

@@ -0,0 +1,48 @@
+### Agtm Run CLI Documentation
+
+Execution of Agent Cli with hints and auto completion.
+
+The `run` command executes agent workflows with interactive hints and fuzzy CLI completion. Typing a few characters surfaces suggested commands so you can finish the full invocation quickly (for example, typing `play` will suggest the Playwright runner).
+
+Let's say you want to run an agent command of Playwright to go to a URL and fetch a webpage. You don't need to remember the full command—type `play`, pick the provider, then pick the CLI action.
+
+### Usage
+
+```
+agtm run <provider_unique_id> <agent_cli>
+```
+
+### Example 
+
+```shell
+rockingdingo@rockingdingodeMacBook-Pro skills_cli % agtm run play
+DEBUG: Entering Human Mode | idArg play | commandArgs  | options [object Object] | hasHints true | hints [object Object]
+
+Skill ID suggestions:
+  1. microsoft/playwright-cli
+  2. googleworkspace/cli
+Skill ID suggestions: 1
+Command hints:
+  1. playwright-cli goto <url> # navigate to a url
+  2. playwright-cli open [url] # open browser, optionally navigate to url
+
+Select command (number or input custom): 1
+Final command [playwright-cli goto <url>]: playwright-cli goto https://www.github.com
+agtm run microsoft/playwright-cli playwright-cli goto https://www.github.com
+```
+
+Support CLI List, Please welcome to contrib
+
+| unique_id | agent cli |
+| --- | --- |
+| microsoft/playwright-cli | playwright-cli open [url], playwright-cli goto <url>
+| googleworkspace/cli | gws drive files list --params
+| aiagenta2z/onekey-gateway | onekey agent <unique_id> <api_id> <data_json|@file>, onekey mcp <server_name> [--name config_name], onekey llm --provider <provider> --model <model> --messages <json|@file> [--temperature <num>] [--response-format <format>] [--options <json|@file>], onekey llm --payload <json|@file>
+| 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
+
+
+