agent-toolkit-cli 1.12.0 → 1.12.2
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 +277 -6
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -1,14 +1,285 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://github.com/ulises-jeremias/agent-toolkit/blob/main/static/banner.svg?raw=true" width="100%" alt="agent-toolkit banner">
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
<div align="center">
|
|
6
|
+
|
|
7
|
+
# agent-toolkit-cli
|
|
8
|
+
|
|
9
|
+
**The official CLI for [agent-toolkit](https://github.com/ulises-jeremias/agent-toolkit)** — install skills, agents, loops, and MCP configs across every major AI coding assistant.
|
|
10
|
+
|
|
11
|
+
[](https://www.npmjs.com/package/agent-toolkit-cli)
|
|
12
|
+
[](https://www.npmjs.com/package/agent-toolkit-cli)
|
|
13
|
+
[](https://github.com/ulises-jeremias/agent-toolkit/blob/main/LICENSE)
|
|
14
|
+
[](https://github.com/ulises-jeremias/agent-toolkit/actions/workflows/validate.yml)
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
[](https://github.com/ulises-jeremias/agent-toolkit/tree/main/profiles/claude-code)
|
|
21
|
+
[](https://github.com/ulises-jeremias/agent-toolkit/tree/main/profiles/cursor)
|
|
22
|
+
[](https://github.com/ulises-jeremias/agent-toolkit/tree/main/profiles/opencode)
|
|
23
|
+
[](https://github.com/ulises-jeremias/agent-toolkit/tree/main/profiles/copilot)
|
|
24
|
+
[](https://github.com/ulises-jeremias/agent-toolkit/tree/main/profiles/windsurf)
|
|
25
|
+
[](https://github.com/ulises-jeremias/agent-toolkit/tree/main/profiles/pi)
|
|
26
|
+
|
|
27
|
+
[Monorepo](https://github.com/ulises-jeremias/agent-toolkit) ·
|
|
28
|
+
[Docs](https://github.com/ulises-jeremias/agent-toolkit/tree/main/docs) ·
|
|
29
|
+
[Installation](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/INSTALLATION.md) ·
|
|
30
|
+
[CLI surfaces](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/CLI_SURFACES.md) ·
|
|
31
|
+
[Changelog](https://github.com/ulises-jeremias/agent-toolkit/blob/main/CHANGELOG.md)
|
|
32
|
+
|
|
33
|
+
</div>
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## What is this package?
|
|
38
|
+
|
|
39
|
+
`agent-toolkit-cli` on npm is the **Node adapter** for the agent-toolkit monorepo ([ADR-025](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/adrs/ADR-025-npm-binary.md)). It is a **thin launcher** — no JavaScript business logic. The real CLI is the native **V** binary from [GitHub Releases](https://github.com/ulises-jeremias/agent-toolkit/releases/latest).
|
|
40
|
+
|
|
41
|
+
Same product name as [PyPI](https://pypi.org/project/agent-toolkit-cli/). Same binary. Different install channel.
|
|
4
42
|
|
|
5
43
|
```bash
|
|
6
44
|
npm install -g agent-toolkit-cli
|
|
7
|
-
agent-toolkit
|
|
45
|
+
agent-toolkit install
|
|
46
|
+
agent-toolkit doctor
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
<div align="center">
|
|
50
|
+
<img src="https://github.com/ulises-jeremias/agent-toolkit/blob/main/static/architecture.svg?raw=true" width="88%" alt="agent-toolkit architecture">
|
|
51
|
+
</div>
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## How the binary arrives
|
|
56
|
+
|
|
57
|
+
npm cannot ship one ELF for every OS the way pip ships platform-tagged wheels. Instead:
|
|
58
|
+
|
|
59
|
+
| Package | Role |
|
|
60
|
+
|---------|------|
|
|
61
|
+
| **`agent-toolkit-cli`** (this package) | Meta-package: `bin/agent-toolkit` → thin Node launcher |
|
|
62
|
+
| `agent-toolkit-cli-linux-x64` | glibc ELF (optionalDependency) |
|
|
63
|
+
| `agent-toolkit-cli-linux-arm64` | glibc ELF (optionalDependency) |
|
|
64
|
+
| `agent-toolkit-cli-darwin-arm64` | macOS arm64 Mach-O |
|
|
65
|
+
| `agent-toolkit-cli-darwin-x64` | macOS x86_64 Mach-O |
|
|
66
|
+
| `agent-toolkit-cli-win32-x64` | Windows PE |
|
|
67
|
+
|
|
68
|
+
On install, npm pulls the matching platform package via `optionalDependencies`. The launcher resolves that binary and spawns it with forwarded argv, stdio, signals, and exit code.
|
|
69
|
+
|
|
70
|
+
**Platform notes**
|
|
71
|
+
|
|
72
|
+
- Linux packages require **glibc** (ADR-019). Alpine/musl is not a MUST npm tag.
|
|
73
|
+
- Node **≥ 18**
|
|
74
|
+
- Dev override: `AGENT_TOOLKIT_BIN=/path/to/agent-toolkit`
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## Quick start
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
# Global install (recommended for shells)
|
|
82
|
+
npm install -g agent-toolkit-cli
|
|
83
|
+
agent-toolkit install # auto-detects Claude, Cursor, OpenCode, Windsurf, Pi, Copilot
|
|
84
|
+
agent-toolkit doctor
|
|
85
|
+
|
|
86
|
+
# Or project-local
|
|
87
|
+
npx agent-toolkit-cli doctor
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
### Other installers
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
# PyPI (same CLI name, platform wheels)
|
|
94
|
+
uvx --from agent-toolkit-cli agent-toolkit install
|
|
95
|
+
uv tool install agent-toolkit-cli
|
|
96
|
+
|
|
97
|
+
# System packages (release notify → dedicated taps)
|
|
98
|
+
brew tap ulises-jeremias/homebrew-tap && brew install agent-toolkit
|
|
99
|
+
yay -S agent-toolkit-bin # Arch Linux (AUR)
|
|
100
|
+
|
|
101
|
+
# Direct binary
|
|
102
|
+
# https://github.com/ulises-jeremias/agent-toolkit/releases/latest
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Full walkthrough: [docs/INSTALLATION.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/INSTALLATION.md)
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Key concepts
|
|
110
|
+
|
|
111
|
+
<table>
|
|
112
|
+
<tr>
|
|
113
|
+
<td width="50%" valign="top">
|
|
114
|
+
<h3>🛠️ Skills</h3>
|
|
115
|
+
<sub>Reusable capability units (<code>SKILL.md</code>) that teach an agent how to do a job — delivery, forge CLIs, design, data, ops.</sub>
|
|
116
|
+
<br><br>
|
|
117
|
+
<sub>77 skills across domains. Browse with <code>agent-toolkit inventory</code> or <code>agent-toolkit skills list</code>.</sub>
|
|
118
|
+
</td>
|
|
119
|
+
<td width="50%" valign="top">
|
|
120
|
+
<h3>🤖 Agents</h3>
|
|
121
|
+
<sub>Personas that constrain <em>how</em> the AI works — review, plan, architect, fix CI — without rewriting prompts each time.</sub>
|
|
122
|
+
<br><br>
|
|
123
|
+
<sub>17 personas, compiled into each target's native format via <code>install</code>.</sub>
|
|
124
|
+
</td>
|
|
125
|
+
</tr>
|
|
126
|
+
<tr>
|
|
127
|
+
<td width="50%" valign="top">
|
|
128
|
+
<h3>🔄 Loops</h3>
|
|
129
|
+
<sub>Recurring agentic workflows with mutation-safety tiers (L1 observe → L2 controlled → L3 high autonomy).</sub>
|
|
130
|
+
<br><br>
|
|
131
|
+
<sub><code>agent-toolkit loop run daily-triage</code> · 10 bundled templates</sub>
|
|
132
|
+
</td>
|
|
133
|
+
<td width="50%" valign="top">
|
|
134
|
+
<h3>🔗 MCP</h3>
|
|
135
|
+
<sub>Provider registry + ready templates (GitHub, Slack, Notion, Linear, Figma, ClickUp) emitted into target-native configs.</sub>
|
|
136
|
+
<br><br>
|
|
137
|
+
<sub><code>agent-toolkit mcp list</code> · <code>mcp setup <provider></code> · <code>mcp doctor</code></sub>
|
|
138
|
+
</td>
|
|
139
|
+
</tr>
|
|
140
|
+
</table>
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## Supported tools
|
|
145
|
+
|
|
146
|
+
<div align="center">
|
|
147
|
+
<img src="https://github.com/ulises-jeremias/agent-toolkit/blob/main/static/tools-grid.svg?raw=true" width="96%" alt="Supported AI tools grid">
|
|
148
|
+
</div>
|
|
149
|
+
|
|
150
|
+
| Tool | What `install` deploys |
|
|
151
|
+
|------|------------------------|
|
|
152
|
+
| **Claude Code** | Plugin manifest, skill references, settings |
|
|
153
|
+
| **Cursor** | Marketplace plugins + `.mdc` rules (IDE + Agent CLI) |
|
|
154
|
+
| **OpenCode** | System prompt overlays, agent configs |
|
|
155
|
+
| **GitHub Copilot** | `copilot-instructions.md` with domain selection |
|
|
156
|
+
| **Windsurf** | Rules and memory files via Cascade (`~/.codeium/windsurf/`) |
|
|
157
|
+
| **Pi Agent** | Skills and loop templates in Pi's native format |
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
agent-toolkit install --tools claude-code,cursor
|
|
161
|
+
agent-toolkit install --dry-run
|
|
162
|
+
agent-toolkit install --force
|
|
8
163
|
```
|
|
9
164
|
|
|
10
|
-
|
|
165
|
+
---
|
|
166
|
+
|
|
167
|
+
## Command reference
|
|
168
|
+
|
|
169
|
+
Everyday **consumer** commands vs **advanced** workstation / harness commands.
|
|
170
|
+
Details: [docs/CLI_SURFACES.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/CLI_SURFACES.md)
|
|
171
|
+
|
|
172
|
+
### Consumer
|
|
173
|
+
|
|
174
|
+
| Command | Purpose |
|
|
175
|
+
|---------|---------|
|
|
176
|
+
| `install` | Install profiles for detected or selected AI tools |
|
|
177
|
+
| `update` | Refresh installed profiles from latest toolkit data |
|
|
178
|
+
| `uninstall` | Remove toolkit-owned files using install receipts |
|
|
179
|
+
| `doctor` | Check toolkit data and tool availability |
|
|
180
|
+
| `diff` | Show changes vs currently installed plugin bundles |
|
|
181
|
+
| `skills` | Sync, list, and validate skills |
|
|
182
|
+
| `mcp` | MCP provider setup, health, doctor, uninstall |
|
|
183
|
+
| `plugin` | Plugin bundle sync and check |
|
|
184
|
+
|
|
185
|
+
```bash
|
|
186
|
+
agent-toolkit skills list
|
|
187
|
+
agent-toolkit skills sync --tools claude-code,cursor
|
|
188
|
+
agent-toolkit mcp setup github
|
|
189
|
+
agent-toolkit doctor --fix
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
### Advanced
|
|
193
|
+
|
|
194
|
+
Still on the same binary — start here when running an [agentic-harness](https://github.com/ulises-jeremias/agentic-harness)-style workspace:
|
|
195
|
+
|
|
196
|
+
| Command | Purpose |
|
|
197
|
+
|---------|---------|
|
|
198
|
+
| `loop` | Loop engineering: init, run, status, audit, cost, schedule, sync |
|
|
199
|
+
| `workspace` | Workspace scaffolding: init, context, personas, packs |
|
|
200
|
+
| `memory` | Knowledge base: add, search, inject, review, todo |
|
|
201
|
+
| `project` | Project index: clone, list, add, remove, scan |
|
|
202
|
+
| `devcompanion` | Background job queue (`dc` alias) |
|
|
203
|
+
| `insights` | Local usage analytics (OpenCode, Cursor, Claude) |
|
|
204
|
+
| `inventory` | List skills, agents, and products |
|
|
205
|
+
| `matrix` | Platform capability matrix |
|
|
206
|
+
| `build` / `release` | Compile / release artifacts (maintainer) |
|
|
207
|
+
|
|
208
|
+
<div align="center">
|
|
209
|
+
<img src="https://github.com/ulises-jeremias/agent-toolkit/blob/main/static/loop-tiers.svg?raw=true" width="88%" alt="Loop autonomy tiers">
|
|
210
|
+
</div>
|
|
211
|
+
|
|
212
|
+
---
|
|
213
|
+
|
|
214
|
+
## Upgrade & uninstall
|
|
215
|
+
|
|
216
|
+
```bash
|
|
217
|
+
npm update -g agent-toolkit-cli
|
|
218
|
+
agent-toolkit update # refresh deployed profiles
|
|
219
|
+
agent-toolkit uninstall # remove toolkit-owned files via receipts
|
|
220
|
+
|
|
221
|
+
npm uninstall -g agent-toolkit-cli
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
→ [docs/UNINSTALL.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/UNINSTALL.md)
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
228
|
+
## Ecosystem
|
|
229
|
+
|
|
230
|
+
`agent-toolkit` is the **capability distribution layer (L1.5)** in a personal DX stack:
|
|
231
|
+
|
|
232
|
+
| Layer | Repo | Role |
|
|
233
|
+
|-------|------|------|
|
|
234
|
+
| **L1** | [agentic-workstation](https://github.com/ulises-jeremias/agentic-workstation) | Machine provisioning — chezmoi, shell, packages, LLM policy |
|
|
235
|
+
| **L1.5** | **agent-toolkit** (this CLI) | Skills, loops, profiles, MCP |
|
|
236
|
+
| **L3** | [agentic-harness](https://github.com/ulises-jeremias/agentic-harness) | AI workspace scaffold — memory, personas, multi-repo orchestration |
|
|
237
|
+
|
|
238
|
+
---
|
|
239
|
+
|
|
240
|
+
## Documentation
|
|
241
|
+
|
|
242
|
+
| Guide | Description |
|
|
243
|
+
|-------|-------------|
|
|
244
|
+
| [README (monorepo)](https://github.com/ulises-jeremias/agent-toolkit#readme) | Full product overview, skills, agents, packs |
|
|
245
|
+
| [INSTALLATION.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/INSTALLATION.md) | Install paths per tool |
|
|
246
|
+
| [CLI_SURFACES.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/CLI_SURFACES.md) | Consumer vs advanced commands |
|
|
247
|
+
| [ADR-025](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/adrs/ADR-025-npm-binary.md) | npm topology (meta + optionalDeps) |
|
|
248
|
+
| [TRUST.md](https://github.com/ulises-jeremias/agent-toolkit/blob/main/docs/TRUST.md) | Trust boundaries and supply chain |
|
|
249
|
+
| [Wiki](https://github.com/ulises-jeremias/agent-toolkit/wiki) | Extended reference |
|
|
250
|
+
|
|
251
|
+
Publish uses GitHub Actions OIDC trusted publishing (`.github/workflows/publish-npm.yml`) — no long-lived `NPM_TOKEN`.
|
|
252
|
+
|
|
253
|
+
Canonical sources live in the [agent-toolkit monorepo](https://github.com/ulises-jeremias/agent-toolkit). This package is the installable npm distribution of that source of truth.
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
## Requirements
|
|
258
|
+
|
|
259
|
+
- **Node.js** 18+
|
|
260
|
+
- Matching platform optionalDependency (installed automatically on supported OS/arch)
|
|
261
|
+
- At least one supported AI coding assistant (for `install` to deploy profiles)
|
|
262
|
+
|
|
263
|
+
---
|
|
264
|
+
|
|
265
|
+
## Contributing
|
|
266
|
+
|
|
267
|
+
Issues and PRs welcome on the monorepo:
|
|
268
|
+
|
|
269
|
+
- [Contributing guide](https://github.com/ulises-jeremias/agent-toolkit/blob/main/CONTRIBUTING.md)
|
|
270
|
+
- [Discord](https://discord.gg/bR5VyATgka)
|
|
271
|
+
|
|
272
|
+
```bash
|
|
273
|
+
git clone https://github.com/ulises-jeremias/agent-toolkit
|
|
274
|
+
cd agent-toolkit
|
|
275
|
+
node packages/npm/agent-toolkit-cli/bin/agent-toolkit.js --help
|
|
276
|
+
# Dev: AGENT_TOOLKIT_BIN=/path/to/native/agent-toolkit
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
---
|
|
280
|
+
|
|
281
|
+
<div align="center">
|
|
11
282
|
|
|
12
|
-
|
|
283
|
+
**MIT** © [ulises-jeremias](https://github.com/ulises-jeremias) · [npm](https://www.npmjs.com/package/agent-toolkit-cli) · [GitHub](https://github.com/ulises-jeremias/agent-toolkit)
|
|
13
284
|
|
|
14
|
-
|
|
285
|
+
</div>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-toolkit-cli",
|
|
3
|
-
"version": "1.12.
|
|
3
|
+
"version": "1.12.2",
|
|
4
4
|
"description": "Thin Node launcher for the agent-toolkit native V CLI (same product as PyPI)",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -28,11 +28,11 @@
|
|
|
28
28
|
"test": "node --test test/launcher.test.js"
|
|
29
29
|
},
|
|
30
30
|
"optionalDependencies": {
|
|
31
|
-
"agent-toolkit-cli-linux-x64": "1.12.
|
|
32
|
-
"agent-toolkit-cli-linux-arm64": "1.12.
|
|
33
|
-
"agent-toolkit-cli-darwin-arm64": "1.12.
|
|
34
|
-
"agent-toolkit-cli-darwin-x64": "1.12.
|
|
35
|
-
"agent-toolkit-cli-win32-x64": "1.12.
|
|
31
|
+
"agent-toolkit-cli-linux-x64": "1.12.2",
|
|
32
|
+
"agent-toolkit-cli-linux-arm64": "1.12.2",
|
|
33
|
+
"agent-toolkit-cli-darwin-arm64": "1.12.2",
|
|
34
|
+
"agent-toolkit-cli-darwin-x64": "1.12.2",
|
|
35
|
+
"agent-toolkit-cli-win32-x64": "1.12.2"
|
|
36
36
|
},
|
|
37
37
|
"keywords": [
|
|
38
38
|
"agent-toolkit",
|