@aiagenta2z/agtm 1.0.7 → 1.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +163 -201
- package/data/config/hints/base_hints.json +118 -0
- package/data/config/hints/contrib/your_cli_hints.json +0 -0
- package/data/config/levels/marketing_sales_apple_levels.json +83 -0
- package/data/config/levels/software_engineer_google_levels.json +42 -0
- package/data/config/levels/software_engineer_meta_levels.json +42 -0
- package/dist/agtm-cli.js +1110 -8
- package/dist/test/skills.spec.js +93 -0
- package/docs/registry/README.md +239 -0
- package/docs/run/README.md +48 -0
- package/docs/skills/README.md +300 -0
- package/package.json +7 -3
package/README.md
CHANGED
|
@@ -1,297 +1,259 @@
|
|
|
1
1
|
|
|
2
|
-
### agtm:
|
|
2
|
+
### agtm: CLI Tool for AI Agent Management, Skills, Agent Registry, Benchmarks and Hints in AI Agent Marketplace
|
|
3
3
|
|
|
4
4
|
[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 Agent Router](https://www.deepnlp.org/agent/onekey-mcp-router) | [Agent MCP OneKey Router Ranking](https://www.deepnlp.org/agent/rankings) | [NodeJS agtm](https://www.npmjs.com/package/@aiagenta2z/agtm)
|
|
5
5
|
|
|
6
|
+
`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.
|
|
6
7
|
|
|
7
|
-
|
|
8
|
-
or a github repo URL in a few seconds.
|
|
8
|
+
Features
|
|
9
9
|
|
|
10
|
-
|
|
11
|
-
|
|
10
|
+
*`agtm skills`*: Manage Skills, Add Skills, List Skills, Log Skills Performance, Skills performance Evaluator, compare to realworld benchmarks
|
|
11
|
+
*`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
|
|
12
|
+
*`agtm search`*: Search the open source AI Agent Marketplace, including github community, huggingface community, product hunt community, deepnlp ai agent marketplace index, etc
|
|
13
|
+
*`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.
|
|
12
14
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
Agtm CLI Options
|
|
16
|
-
|
|
17
|
-
### `search`
|
|
18
|
-
`agtm search` helps to search AI Agent MCP and skills marketplace by id or query keywords.
|
|
15
|
+
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 prefessional, etc.
|
|
19
16
|
|
|
20
|
-
Example Usage
|
|
21
17
|
```shell
|
|
22
|
-
|
|
23
|
-
|
|
18
|
+
skill_id run_times score level
|
|
19
|
+
------------------- --------- ----- -----
|
|
20
|
+
code_success_skills 5 0.9 L3(100%)
|
|
24
21
|
```
|
|
25
22
|
|
|
26
|
-
|
|
27
|
-
`agtm update` helps to update your local agent.json or agent.yaml meta information to DeepNLP AI Agent Marketplace Index.
|
|
28
|
-
Example Usage
|
|
29
|
-
```shell
|
|
30
|
-
agtm upload --github https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent
|
|
31
|
-
agtm upload --config ./agent.json
|
|
32
|
-
agtm upload --config ./agent.yaml
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
### `add`
|
|
36
|
-
`agtm add` Install Skills from Github
|
|
37
|
-
|
|
38
|
-
Example Usage
|
|
39
|
-
```shell
|
|
40
|
-
agtm add aiagenta2z/onekey-agent-router --skill google-maps ## install to your project folder
|
|
41
|
-
agtm add aiagenta2z/onekey-agent-router --skill google-maps -g ## install to global cache folder
|
|
42
|
-
agtm add https://github.com/aiagenta2z/onekey-agent-router --skill google-maps ## install one skill
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
Expected Results install google-maps
|
|
46
|
-
```shell
|
|
47
|
-
Installed skill 'google-maps' to antigravity at /path/to/project/.agent/skills/google-maps
|
|
48
|
-
Installed skill 'google-maps' to codex at /path/to/project/.agents/skills/google-maps
|
|
49
|
-
Installed skill 'google-maps' to claude-code at /path/to/project/.claude/skills/google-maps
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
## Tutorial
|
|
23
|
+
## Quickstart
|
|
54
24
|
|
|
55
|
-
###
|
|
25
|
+
### Installation
|
|
56
26
|
|
|
57
27
|
**Node**
|
|
58
28
|
``` NodeJS
|
|
59
29
|
npm install -g @aiagenta2z/agtm
|
|
60
30
|
```
|
|
61
31
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
Command line to register your AI agent from GitHub, Local config(agent.json, agent.yaml) or search the AI agent marketplace.
|
|
65
|
-
To see detailed usage, visit the GitHub of `agtm` at Documentation (https://github.com/aiagenta2z/ai-agent-marketplace)
|
|
66
|
-
|
|
67
|
-
**Python**
|
|
68
|
-
```
|
|
69
|
-
pip install ai-agent-marketplace
|
|
70
|
-
```
|
|
32
|
+
Agtm CLI Options
|
|
71
33
|
|
|
72
|
-
|
|
34
|
+
| CLI | Command and Options | Document |
|
|
35
|
+
|-------------|-------------------------------------------|--------------------------------|
|
|
36
|
+
| agtm skills | add, list, log, rate | [Doc](../docs/skills/README.md) |
|
|
37
|
+
| agtm search | --q query | [Doc](../docs/registry/README.md) |
|
|
38
|
+
| agtm upload | --github --config to local agent meta | [Doc](../docs/registry/README.md) |
|
|
39
|
+
| agtm run | --hint agent-cli hint and auto completion | [Doc](../docs/run/README.md) |
|
|
73
40
|
|
|
74
|
-
|
|
75
|
-
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
|
|
76
|
-
register and get a registered detailed page of AI Agent in the marketplace and monitor the traffic.
|
|
41
|
+
## `skills`
|
|
77
42
|
|
|
78
|
-
|
|
43
|
+
### skills add
|
|
79
44
|
|
|
80
|
-
|
|
81
|
-
Register your AI Agent Marketplace [Access Key here](https://deepnlp.org/workspace/keys)
|
|
45
|
+
Download and add skills to your agent directory.
|
|
82
46
|
|
|
47
|
+
#### Usage
|
|
83
48
|
```
|
|
84
|
-
|
|
49
|
+
agtm skills add <unique_id>
|
|
50
|
+
agtm skills add <github_url>
|
|
51
|
+
agtm skills add <github_url> -a <agent_id>
|
|
52
|
+
agtm skills add <owner_id/repo_id> -s <skill_id>
|
|
85
53
|
```
|
|
86
54
|
|
|
87
|
-
|
|
88
|
-
|
|
55
|
+
#### Example
|
|
89
56
|
```
|
|
90
|
-
|
|
57
|
+
agtm skills add anthropics/skills -a claude-code ## install skills only to claude-codex
|
|
58
|
+
agtm skills add msitarzewski/agency-agents
|
|
59
|
+
agtm skills add aiagenta2z/onekey-gateway
|
|
60
|
+
agtm skills add msitarzewski/agency-agents -s academic-anthropologist -a codex
|
|
61
|
+
agtm skills add anthropics/skills -s skill-creator -a claude-code --global
|
|
91
62
|
```
|
|
92
63
|
|
|
93
|
-
###
|
|
94
|
-
|
|
95
|
-
Install skills from the `aiagenta2z/onekey-agent-router` Github repo (`user_name/repo_name`). The `google-maps` skill is a good starter example.
|
|
96
|
-
|
|
97
|
-
Under the `./skills/google-maps` folder of the target github repo.
|
|
64
|
+
### skills list
|
|
98
65
|
|
|
99
|
-
|
|
100
|
-
agtm add aiagenta2z/onekey-agent-router --skill google-maps
|
|
66
|
+
#### Usage
|
|
101
67
|
```
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
```shell
|
|
106
|
-
agtm add aiagenta2z/onekey-agent-router --skill google-maps -a codex
|
|
68
|
+
agtm skills list
|
|
69
|
+
agtm skills list --agent <agent_id> --global
|
|
107
70
|
```
|
|
71
|
+
Lists installed skills with `agent`, `skill_id`, `description`, install `path`, average `score`, and aggregated `level` (if ratings exist).
|
|
108
72
|
|
|
109
|
-
Install to a specific agent (openclaw):
|
|
110
|
-
|
|
111
|
-
```shell
|
|
112
|
-
agtm add aiagenta2z/onekey-agent-router --skill google-maps -a openclaw
|
|
113
|
-
```
|
|
114
73
|
|
|
115
|
-
Install to global paths instead of local project paths:
|
|
116
74
|
|
|
117
|
-
|
|
118
|
-
|
|
75
|
+
#### Example
|
|
76
|
+
```
|
|
77
|
+
agtm skills list
|
|
78
|
+
agtm skills list --agent codex
|
|
79
|
+
agtm skills list --agent claude-code --global
|
|
119
80
|
```
|
|
120
81
|
|
|
121
82
|
|
|
122
|
-
###
|
|
123
|
-
|
|
124
|
-
**Registry AI Agent from your GitHub**
|
|
125
|
-
|
|
126
|
-
The default registry provider endpoint includes: [DeepNLP AI Agent Registry Endpoint](https://www.deepnlp.org/api/ai_agent_marketplace/registry) |
|
|
127
|
-
[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.
|
|
128
|
-
|
|
129
|
-
You can also set your customized registry endpoint via `--endpoint` parameter
|
|
130
|
-
|
|
83
|
+
### skills log
|
|
131
84
|
|
|
85
|
+
#### Usage
|
|
132
86
|
```
|
|
133
|
-
agtm
|
|
87
|
+
agtm skills log <skill_id> --data '<json_payload>'
|
|
134
88
|
```
|
|
89
|
+
- Persists a run record at `.agtm/skills/log/<uuid>.json` (or the `--logDir` you supply).
|
|
90
|
+
- `<json_payload>` must contain at least `input` and `output`; optional fields (meta, rating, level) are accepted.
|
|
135
91
|
|
|
92
|
+
#### Example
|
|
93
|
+
```
|
|
94
|
+
agtm skills log <skill_id> --data '{"input":"write a website for store","output":"success"}'
|
|
95
|
+
agtm skills log code_success_skills --data '{"input":"generate sql","output":"ok","meta":{"agent":"claude-code"}}'
|
|
96
|
+
```
|
|
136
97
|
|
|
137
|
-
|
|
98
|
+
### skills rate
|
|
138
99
|
|
|
100
|
+
#### Setup
|
|
139
101
|
|
|
102
|
+
To use the rate command, have to setup the benchmark levels configuration. save to `./agtm/levels/*.json` files
|
|
103
|
+
```shell
|
|
104
|
+
agtm setup --levels
|
|
140
105
|
```
|
|
141
106
|
|
|
142
|
-
|
|
143
|
-
agtm upload --config ./agent.json
|
|
144
|
-
agtm upload --config ./agent.yaml
|
|
107
|
+
#### Usage
|
|
145
108
|
```
|
|
109
|
+
agtm skills rate prepare --skill_id <skill_id> --prompt "<eval_prompt>" --benchmark <path/benchmark.json>
|
|
110
|
+
agtm skills rate apply --skill_id <skill_id> --result '<result_json>'
|
|
111
|
+
agtm skills rate show --skill_id <skill_id>
|
|
112
|
+
```
|
|
113
|
+
- `prepare` exports logs plus the top benchmark slices (e.g., Google SWE L3–L7) for an external evaluator.
|
|
114
|
+
- `apply` writes evaluator outputs (`rating`, `level`) back to each log.
|
|
115
|
+
- `show` summarizes run counts, average score, and level distribution.
|
|
146
116
|
|
|
147
|
-
|
|
148
|
-
See the explanation of the schema, please visit the [documentation](https://www.deepnlp.org/doc/ai_agent_marketplace).
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
Demo agent.json file
|
|
117
|
+
#### Example
|
|
152
118
|
```
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
"website": "https://www.my_first_agent.com",
|
|
157
|
-
"field": "AI AGENT",
|
|
158
|
-
"subfield": "Coding Agent",
|
|
159
|
-
"content_tag_list": "coding,python",
|
|
160
|
-
"github": "",
|
|
161
|
-
"thumbnail_picture": "https://avatars.githubusercontent.com/u/242328252?s=200&v=4",
|
|
162
|
-
"upload_image_files": "",
|
|
163
|
-
"api": "https://www.my_first_agent.com/agent",
|
|
164
|
-
"price_type": "PER_CALL",
|
|
165
|
-
"price_per_call_credit": 0.0,
|
|
166
|
-
"price_fixed_credit" : 0.0,
|
|
167
|
-
"price_subscription": "Basic: your basic plan introduction, Advanced: Your Advanced Plan introduction, etc."
|
|
168
|
-
}
|
|
119
|
+
agtm skills rate prepare --skill_id code_success_skills --prompt "Evaluate the results" --benchmark path/customized_agent_benchmark.json
|
|
120
|
+
agtm skills rate apply --skill_id code_success_skills --result '{"results":[{"log_id":"3679a3fe-4d97-4eb1-83bc-f83d711be195","rating":0.90,"level":"L4"}]}'
|
|
121
|
+
agtm skills rate show --skill_id code_success_skills
|
|
169
122
|
```
|
|
170
|
-
|
|
123
|
+
Sample output:
|
|
171
124
|
```
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
website: "https://www.my_first_agent.com"
|
|
176
|
-
field: "AI AGENT"
|
|
177
|
-
subfield: "Coding Agent"
|
|
178
|
-
content_tag_list: "coding,python"
|
|
179
|
-
github: "https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent"
|
|
180
|
-
thumbnail_picture: "https://avatars.githubusercontent.com/u/242328252?s=200&v=4"
|
|
181
|
-
upload_image_files: ""
|
|
182
|
-
api: "https://www.my_first_agent.com/agent"
|
|
183
|
-
price_type: "API Call"
|
|
184
|
-
price_per_call_credit: 0.0
|
|
185
|
-
price_fixed_credit: 0.0
|
|
186
|
-
price_subscription: "Basic: your basic plan introduction, Advanced: Your Advanced Plan introduction, etc."
|
|
187
|
-
|
|
125
|
+
skill_id run_times score level
|
|
126
|
+
------------------- --------- ----- -----
|
|
127
|
+
code_success_skills 3 0.88 L4(100%)
|
|
188
128
|
```
|
|
129
|
+
Benchmarks live in `data/config/levels/*.json` and follow this structure:
|
|
130
|
+
```
|
|
131
|
+
{
|
|
132
|
+
"software-engineering": {
|
|
133
|
+
"Google": [
|
|
134
|
+
{ "level": "L3", "title": "Software Engineer II", "description": "Entry-level engineer. Delivers well-scoped tasks with guidance.", "signals": ["task execution","learning velocity","code quality basics"] },
|
|
135
|
+
{ "level": "L4", "title": "Software Engineer III", "description": "Independent contributor. Owns small features end-to-end.", "signals": ["ownership","code quality","debugging ability"] }
|
|
136
|
+
]
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
```
|
|
140
|
+
The evaluator compares each `<input,output>` log to the benchmark definitions and assigns a rating. You can customize levels such as `poor`, `fair`, `good`, `excellent` in your benchmark file.
|
|
189
141
|
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
You have the flexibility to use the AI Agent marketplace/manager cli `agtm` to submit customized ai agent schema to your customized endpoint.
|
|
193
|
-
|
|
194
|
-
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`.
|
|
195
|
-
Then the package will POST the the data schema to your endpoint.
|
|
196
|
-
|
|
142
|
+
Partial List of Skills and Job Level Description
|
|
197
143
|
|
|
198
|
-
|
|
144
|
+
| Job Category | Company | Levels Description (e.g. Google L3, Meta E4) |
|
|
145
|
+
|-------------------|---------|-------------------------------------------------------------------------------------------|
|
|
146
|
+
| Marketing | Apple | [marketing_sales_apple_levels.json](data/config/levels/marketing_sales_apple_levels.json) |
|
|
147
|
+
| Software Engineer | Google | [software_engineer_google_levels.json](data/config/levels/software_engineer_google_levels.json) |
|
|
148
|
+
| Software Engineer | Meta | [software_engineer_meta_levels.json](data/config/levels/software_engineer_meta_levels.json) |
|
|
199
149
|
|
|
200
150
|
|
|
201
|
-
`
|
|
151
|
+
write your `customized_agent_benchmark.json` following the formats
|
|
202
152
|
|
|
203
|
-
Remember to keep the `access_key` in safe place, the post request will post the `access_key` as well as schema to the endpoint.
|
|
204
|
-
|
|
205
|
-
#### default schema.json definition
|
|
206
153
|
```
|
|
207
154
|
{
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
"website",
|
|
214
|
-
"field",
|
|
215
|
-
"subfield",
|
|
216
|
-
"content_tag_list",
|
|
217
|
-
"github",
|
|
218
|
-
"price_type",
|
|
219
|
-
"api",
|
|
220
|
-
"thumbnail_picture",
|
|
221
|
-
"upload_image_files",
|
|
222
|
-
"sdk",
|
|
223
|
-
"package"
|
|
155
|
+
"domain": {
|
|
156
|
+
"my_benchmark": [
|
|
157
|
+
{ "level": "poor", "description": "the skill failed or the output is meaningless"},
|
|
158
|
+
{ "level": "fair", "description": "the skills produces fair results, complete the task"},
|
|
159
|
+
{ "level": "good", "description": "the skills output a report, an image is good in real life standards.."},
|
|
224
160
|
]
|
|
161
|
+
}
|
|
225
162
|
}
|
|
226
163
|
```
|
|
227
164
|
|
|
228
165
|
|
|
229
|
-
|
|
166
|
+
## `Run`
|
|
230
167
|
|
|
168
|
+
Execution of Agent Cli with hints and auto completion.
|
|
231
169
|
|
|
232
|
-
|
|
170
|
+
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).
|
|
233
171
|
|
|
234
|
-
|
|
235
|
-
export AI_AGENT_MARKETPLACE_ACCESS_KEY="TEST_KEY_AI_AGENT_REGISTRY"
|
|
172
|
+
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.
|
|
236
173
|
|
|
237
|
-
|
|
174
|
+
### Usage
|
|
238
175
|
|
|
239
|
-
|
|
176
|
+
```
|
|
177
|
+
agtm run <provider_unique_id> <agent_cli>
|
|
240
178
|
```
|
|
241
179
|
|
|
180
|
+
### Example
|
|
242
181
|
|
|
243
|
-
```
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
182
|
+
```shell
|
|
183
|
+
rockingdingo@rockingdingodeMacBook-Pro skills_cli % agtm run play
|
|
184
|
+
DEBUG: Entering Human Mode | idArg play | commandArgs | options [object Object] | hasHints true | hints [object Object]
|
|
185
|
+
|
|
186
|
+
Skill ID suggestions:
|
|
187
|
+
1. microsoft/playwright-cli
|
|
188
|
+
2. googleworkspace/cli
|
|
189
|
+
Skill ID suggestions: 1
|
|
190
|
+
Command hints:
|
|
191
|
+
1. playwright-cli goto <url> # navigate to a url
|
|
192
|
+
2. playwright-cli open [url] # open browser, optionally navigate to url
|
|
251
193
|
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
Track its status at: https://www.deepnlp.org/store/ai-agent/coding-agent/pub-test-agtm-registry/my-first-ai-coding-agent
|
|
194
|
+
Select command (number or input custom): 1
|
|
195
|
+
Final command [playwright-cli goto <url>]: playwright-cli goto https://www.github.com
|
|
196
|
+
agtm run microsoft/playwright-cli playwright-cli goto https://www.github.com
|
|
256
197
|
```
|
|
257
198
|
|
|
199
|
+
Support CLI List, Please welcome to contrib
|
|
258
200
|
|
|
259
|
-
|
|
201
|
+
| unique_id | agent cli |
|
|
202
|
+
| --- | --- |
|
|
203
|
+
| microsoft/playwright-cli | playwright-cli open [url], playwright-cli goto <url>
|
|
204
|
+
| googleworkspace/cli | gws drive files list --params
|
|
205
|
+
| 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>
|
|
206
|
+
| openai/codex-cli | codex, codex exec "[instruction]"
|
|
207
|
+
| anthropic/claude-code | claude "[prompt]", claude --dangerously-skip-permissions
|
|
208
|
+
| paul-gauthier/aider | aider --model [model_name], /test [command]
|
|
209
|
+
| openinterpreter/open-interpreter | interpreter, interpreter --os
|
|
210
|
+
| google-gemini/gemini-cli | gemini, gemini -p "[prompt] @[file/dir]", gemini --yolo, /memory add "[fact]", /mcp list, /restore
|
|
260
211
|
|
|
261
212
|
|
|
213
|
+
## AI Agent Registry
|
|
214
|
+
### `search`
|
|
215
|
+
`agtm search` helps to search AI Agent MCP and skills marketplace by id or query keywords.
|
|
216
|
+
|
|
217
|
+
Example Usage
|
|
218
|
+
```shell
|
|
219
|
+
agtm search --q 'coding agent'
|
|
220
|
+
agtm search --id 'google-maps/google-maps'
|
|
262
221
|
```
|
|
263
|
-
agtm upload --config ./agent.json --endpoint https://www.example.com --schema ./schema.json
|
|
264
222
|
|
|
223
|
+
### `upload`
|
|
224
|
+
`agtm update` helps to update your local agent.json or agent.yaml meta information to DeepNLP AI Agent Marketplace Index.
|
|
225
|
+
Example Usage
|
|
226
|
+
```shell
|
|
227
|
+
agtm upload --github https://github.com/AI-Hub-Admin/My-First-AI-Coding-Agent
|
|
228
|
+
agtm upload --config ./agent.json
|
|
229
|
+
agtm upload --config ./agent.yaml
|
|
265
230
|
```
|
|
266
231
|
|
|
267
|
-
|
|
232
|
+
`schema.json` should have two keys defined the required fields and optional fields you want to submit from the agent.json file.
|
|
268
233
|
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
234
|
+
Remember to keep the `access_key` in safe place, the post request will post the `access_key` as well as schema to the endpoint.
|
|
235
|
+
|
|
236
|
+
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.
|
|
272
237
|
|
|
273
238
|
|
|
274
|
-
|
|
239
|
+
Use the test account and access
|
|
275
240
|
|
|
276
241
|
```
|
|
242
|
+
export AI_AGENT_MARKETPLACE_ACCESS_KEY="TEST_KEY_AI_AGENT_REGISTRY"
|
|
277
243
|
|
|
278
|
-
|
|
244
|
+
agtm upload --config ./agent.json --endpoint https://www.deepnlp.org/api/ai_agent_marketplace/registry --schema ./schema.json
|
|
279
245
|
|
|
280
|
-
agtm
|
|
281
|
-
agtm search --id 'google-maps/google-maps'
|
|
282
|
-
agtm search --id 'AI-Hub-Admin/My-First-AI-Coding-Agent'
|
|
246
|
+
agtm upload --config ./agent.json --endpoint https://www.aiagenta2z.com/api/ai_agent_marketplace/registry --schema ./schema.json
|
|
283
247
|
```
|
|
284
248
|
|
|
285
|
-
|
|
249
|
+
### Contributing
|
|
286
250
|
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
251
|
+
#### Agent CLI List
|
|
252
|
+
You are welcome to contrib your cli list to the agent cli hints json file to folder [hints](data/config/hints) or table README.md
|
|
253
|
+
|
|
254
|
+
#### Skill Run Benchmark
|
|
255
|
+
|
|
256
|
+
You are welcome to contrib your own customized benchmarks of skills and unique levels system in folder [levels](data/config/levels).
|
|
290
257
|
|
|
291
|
-
Search Result of Retrieving registered project id 'AI-Hub-Admin/My-First-AI-Coding-Agent'
|
|
292
258
|
|
|
293
|
-
```
|
|
294
|
-
Retrieving specific agent with unique ID: AI-Hub-Admin/My-First-AI-Coding-Agent
|
|
295
259
|
|
|
296
|
-
{'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'}]}
|
|
297
|
-
```
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
{
|
|
2
|
+
"microsoft/playwright-cli": {
|
|
3
|
+
"hints": [
|
|
4
|
+
{
|
|
5
|
+
"cli": "playwright-cli open [url]",
|
|
6
|
+
"hint": "open browser, optionally navigate to url"
|
|
7
|
+
},
|
|
8
|
+
{
|
|
9
|
+
"cli": "playwright-cli goto <url> ",
|
|
10
|
+
"hint": "navigate to a url"
|
|
11
|
+
}
|
|
12
|
+
]
|
|
13
|
+
},
|
|
14
|
+
"googleworkspace/cli": {
|
|
15
|
+
"hints": [
|
|
16
|
+
{
|
|
17
|
+
"cli": "gws drive files list --params",
|
|
18
|
+
"hint": "List the 10 most recent files"
|
|
19
|
+
}
|
|
20
|
+
]
|
|
21
|
+
},
|
|
22
|
+
"aiagenta2z/onekey-gateway": {
|
|
23
|
+
"hints": [
|
|
24
|
+
{
|
|
25
|
+
"cli": "onekey agent <unique_id> <api_id> <data_json|@file>",
|
|
26
|
+
"hint": "Invoke a specific agent by ID with structured JSON data or a file input"
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"cli": "onekey mcp <server_name> [--name config_name]",
|
|
30
|
+
"hint": "Connect to a Model Context Protocol server to extend agent capabilities"
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"cli": "onekey llm --provider <provider> --model <model> --messages <json|@file> [--temperature <num>] [--response-format <format>] [--options <json|@file>]",
|
|
34
|
+
"hint": "Execute a direct LLM call with granular control over provider, model, and sampling parameters"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"cli": "onekey llm --payload <json|@file>",
|
|
38
|
+
"hint": "Run a raw LLM request using a pre-formatted JSON payload or configuration file"
|
|
39
|
+
}
|
|
40
|
+
]
|
|
41
|
+
},
|
|
42
|
+
"openai/codex-cli": {
|
|
43
|
+
"hints": [
|
|
44
|
+
{
|
|
45
|
+
"cli": "codex",
|
|
46
|
+
"hint": "Start an interactive terminal UI (TUI) coding session"
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
"cli": "codex exec \"[instruction]\"",
|
|
50
|
+
"hint": "Run Codex non-interactively and stream results to stdout"
|
|
51
|
+
}
|
|
52
|
+
]
|
|
53
|
+
},
|
|
54
|
+
"anthropic/claude-code": {
|
|
55
|
+
"hints": [
|
|
56
|
+
{
|
|
57
|
+
"cli": "claude \"[prompt]\"",
|
|
58
|
+
"hint": "Start an interactive session with an initial task"
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
"cli": "claude --dangerously-skip-permissions",
|
|
62
|
+
"hint": "Run without interrupting for tool execution permissions"
|
|
63
|
+
}
|
|
64
|
+
]
|
|
65
|
+
},
|
|
66
|
+
"paul-gauthier/aider": {
|
|
67
|
+
"hints": [
|
|
68
|
+
{
|
|
69
|
+
"cli": "aider --model [model_name]",
|
|
70
|
+
"hint": "Start aider with a specific LLM context"
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
"cli": "/test [command]",
|
|
74
|
+
"hint": "Run a test; aider will automatically attempt to fix code if it fails"
|
|
75
|
+
}
|
|
76
|
+
]
|
|
77
|
+
},
|
|
78
|
+
"openinterpreter/open-interpreter": {
|
|
79
|
+
"hints": [
|
|
80
|
+
{
|
|
81
|
+
"cli": "interpreter",
|
|
82
|
+
"hint": "Launch the natural language interface to control your local computer"
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
"cli": "interpreter --os",
|
|
86
|
+
"hint": "Enable visual/OS-level control for mouse and keyboard automation"
|
|
87
|
+
}
|
|
88
|
+
]
|
|
89
|
+
},
|
|
90
|
+
"google-gemini/gemini-cli": {
|
|
91
|
+
"hints": [
|
|
92
|
+
{
|
|
93
|
+
"cli": "gemini",
|
|
94
|
+
"hint": "Start an interactive agentic session in the current directory"
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"cli": "gemini -p \"[prompt] @[file/dir]\"",
|
|
98
|
+
"hint": "Run a prompt with specific file or directory context injected"
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"cli": "gemini --yolo",
|
|
102
|
+
"hint": "Enable 'YOLO mode' to auto-approve all tool and shell executions"
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"cli": "/memory add \"[fact]\"",
|
|
106
|
+
"hint": "Save a persistent fact to the project's GEMINI.md hierarchical memory"
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
"cli": "/mcp list",
|
|
110
|
+
"hint": "List all active Model Context Protocol servers and available tools"
|
|
111
|
+
},
|
|
112
|
+
{
|
|
113
|
+
"cli": "/restore",
|
|
114
|
+
"hint": "List or restore project state checkpoints created before file edits"
|
|
115
|
+
}
|
|
116
|
+
]
|
|
117
|
+
}
|
|
118
|
+
}
|
|
File without changes
|