anpm-io 1.0.1 → 1.0.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 +168 -97
- package/dist/commands/update.js +2 -2
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,174 +1,245 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<strong>anpm</strong><br>
|
|
3
|
+
<em>The package manager for AI agents</em>
|
|
4
|
+
</p>
|
|
5
|
+
|
|
6
|
+
<p align="center">
|
|
7
|
+
<a href="https://www.npmjs.com/package/anpm-io"><img src="https://img.shields.io/npm/v/anpm-io?color=blue" alt="npm version"></a>
|
|
8
|
+
<a href="https://www.npmjs.com/package/anpm-io"><img src="https://img.shields.io/npm/dm/anpm-io?color=green" alt="npm downloads"></a>
|
|
9
|
+
<a href="https://github.com/anpm-io/anpm/blob/main/LICENSE"><img src="https://img.shields.io/github/license/anpm-io/anpm" alt="MIT License"></a>
|
|
10
|
+
</p>
|
|
2
11
|
|
|
3
|
-
|
|
12
|
+
---
|
|
4
13
|
|
|
5
|
-
|
|
14
|
+
Install, publish, and deploy AI agent packages. Works locally with Claude Code, Cursor, Codex, and 5+ other harnesses — or deploy to the cloud with Anthropic Managed Agents.
|
|
6
15
|
|
|
7
16
|
```bash
|
|
8
|
-
|
|
17
|
+
npm install -g anpm-io
|
|
18
|
+
anpm install @author/agent-name
|
|
9
19
|
```
|
|
10
20
|
|
|
11
21
|
```
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
22
|
+
✓ customer-support installed v1.0.0 by @acme
|
|
23
|
+
path: ~/.anpm/agents/acme/customer-support
|
|
24
|
+
scope: global
|
|
25
|
+
files: 8, symlinks: 3
|
|
26
|
+
|
|
27
|
+
Included commands:
|
|
28
|
+
/support — Handle customer inquiries
|
|
29
|
+
/escalate — Escalate complex issues
|
|
30
|
+
|
|
31
|
+
💡 Usage: /support
|
|
21
32
|
```
|
|
22
33
|
|
|
23
34
|
---
|
|
24
35
|
|
|
25
|
-
## Why
|
|
36
|
+
## Why anpm
|
|
26
37
|
|
|
27
|
-
AI agents are
|
|
38
|
+
AI agents are scattered across repos, gists, and docs with no standard way to discover, install, or track them.
|
|
28
39
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
| Problem | Relay |
|
|
40
|
+
| Problem | anpm |
|
|
32
41
|
|---|---|
|
|
33
|
-
| Agents locked to one
|
|
34
|
-
| No distribution
|
|
35
|
-
|
|
|
42
|
+
| Agents locked to one platform | Works across 8+ local harnesses and cloud deployment |
|
|
43
|
+
| No distribution | `anpm install` — one command, done |
|
|
44
|
+
| No visibility | Built-in install counts, DAU, WAU tracking |
|
|
45
|
+
| No cloud option | `anpm deploy` to Anthropic Managed Agents |
|
|
36
46
|
|
|
37
47
|
---
|
|
38
48
|
|
|
39
49
|
## Quick Start
|
|
40
50
|
|
|
51
|
+
### Install an agent
|
|
52
|
+
|
|
41
53
|
```bash
|
|
42
|
-
#
|
|
43
|
-
npx
|
|
54
|
+
# No global install needed
|
|
55
|
+
npx anpm-io install @author/agent-name
|
|
44
56
|
|
|
45
57
|
# Or install globally
|
|
46
|
-
npm i -g
|
|
47
|
-
|
|
58
|
+
npm i -g anpm-io
|
|
59
|
+
anpm install @author/agent-name
|
|
48
60
|
```
|
|
49
61
|
|
|
50
|
-
|
|
62
|
+
The agent is ready immediately — skills, rules, commands, all wired up.
|
|
63
|
+
|
|
64
|
+
### Install from anywhere
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
# From the registry
|
|
68
|
+
anpm install @acme/customer-support
|
|
69
|
+
|
|
70
|
+
# From GitHub
|
|
71
|
+
anpm install github:user/repo
|
|
72
|
+
|
|
73
|
+
# From a local directory
|
|
74
|
+
anpm install ./my-agent
|
|
75
|
+
|
|
76
|
+
# Public agents — no login required
|
|
77
|
+
anpm install @tools/data-pipeline
|
|
78
|
+
```
|
|
51
79
|
|
|
52
80
|
---
|
|
53
81
|
|
|
54
82
|
## For Agent Builders
|
|
55
83
|
|
|
56
|
-
|
|
57
|
-
# Publish your agent to the registry
|
|
58
|
-
relay publish
|
|
84
|
+
### Create and publish
|
|
59
85
|
|
|
60
|
-
|
|
61
|
-
|
|
86
|
+
```bash
|
|
87
|
+
anpm create my-agent # scaffold a new agent project
|
|
88
|
+
anpm publish # publish to the registry
|
|
89
|
+
anpm publish --patch # bump version and publish
|
|
62
90
|
```
|
|
63
91
|
|
|
64
|
-
|
|
92
|
+
### Deploy to the cloud
|
|
65
93
|
|
|
66
|
-
|
|
94
|
+
Deploy your agent to Anthropic Managed Agents for always-on, serverless execution — no local harness needed.
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
anpm deploy --to anthropic
|
|
98
|
+
```
|
|
67
99
|
|
|
68
100
|
```yaml
|
|
69
|
-
#
|
|
70
|
-
name:
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
101
|
+
# anpm.yaml — cloud deployment config
|
|
102
|
+
name: customer-support
|
|
103
|
+
slug: customer-support
|
|
104
|
+
description: AI-powered customer support agent
|
|
105
|
+
version: 1.0.0
|
|
106
|
+
|
|
107
|
+
agent:
|
|
108
|
+
system: "You are a customer support agent..."
|
|
109
|
+
tools:
|
|
110
|
+
- computer
|
|
111
|
+
- text_editor
|
|
112
|
+
cloud:
|
|
113
|
+
anthropic:
|
|
114
|
+
model: claude-sonnet-4-6
|
|
115
|
+
networking: unrestricted
|
|
83
116
|
```
|
|
84
117
|
|
|
85
|
-
|
|
118
|
+
Managed Agents can handle any task — customer support, research, data analysis, content generation, workflow automation, and more.
|
|
86
119
|
|
|
87
120
|
---
|
|
88
121
|
|
|
89
122
|
## Commands
|
|
90
123
|
|
|
91
|
-
| Command |
|
|
124
|
+
| Command | Description |
|
|
92
125
|
|---|---|
|
|
93
|
-
| `
|
|
94
|
-
| `
|
|
95
|
-
| `
|
|
96
|
-
| `
|
|
97
|
-
| `
|
|
98
|
-
| `
|
|
99
|
-
| `
|
|
100
|
-
| `
|
|
101
|
-
|
|
102
|
-
|
|
126
|
+
| `anpm install [slug]` | Install an agent (registry, git, or local) |
|
|
127
|
+
| `anpm search <keyword>` | Search the marketplace |
|
|
128
|
+
| `anpm publish` | Publish your agent |
|
|
129
|
+
| `anpm deploy` | Deploy to cloud (Anthropic Managed Agents) |
|
|
130
|
+
| `anpm create <name>` | Scaffold a new agent project |
|
|
131
|
+
| `anpm list` | List installed agents |
|
|
132
|
+
| `anpm status` | Show environment and agent status |
|
|
133
|
+
| `anpm update <slug>` | Update to latest version |
|
|
134
|
+
| `anpm run <harness>` | Run harness with isolated agent environment |
|
|
135
|
+
| `anpm link` | Link local agent for development |
|
|
136
|
+
| `anpm config` | Manage CLI configuration |
|
|
137
|
+
|
|
138
|
+
All commands support `--json` for structured output, making anpm fully scriptable by AI agents.
|
|
103
139
|
|
|
104
140
|
---
|
|
105
141
|
|
|
106
142
|
## How It Works
|
|
107
143
|
|
|
108
144
|
```
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
145
|
+
anpm install @team/agent
|
|
146
|
+
│
|
|
147
|
+
╭──────────┴──────────╮
|
|
148
|
+
│ anpm Registry │
|
|
149
|
+
│ (anpm.io) │
|
|
150
|
+
╰──────────┬──────────╯
|
|
151
|
+
│
|
|
152
|
+
┌──────────────┼──────────────┐
|
|
153
|
+
│ │ │
|
|
154
|
+
╭─────┴─────╮ ╭─────┴─────╮ ╭──────┴──────╮
|
|
155
|
+
│ Local │ │ Local │ │ Cloud │
|
|
156
|
+
│ Harness │ │ Harness │ │ Deploy │
|
|
157
|
+
│ │ │ │ │ (Managed │
|
|
158
|
+
│ Claude, │ │ Cursor, │ │ Agents) │
|
|
159
|
+
│ Codex, │ │ Windsurf, │ │ │
|
|
160
|
+
│ Gemini │ │ Cline ... │ │ Anthropic │
|
|
161
|
+
╰───────────╯ ╰───────────╯ ╰─────────────╯
|
|
125
162
|
```
|
|
126
163
|
|
|
127
|
-
|
|
164
|
+
One spec. Local or cloud. anpm handles the rest.
|
|
128
165
|
|
|
129
166
|
---
|
|
130
167
|
|
|
131
|
-
##
|
|
168
|
+
## Environment Lockfile
|
|
132
169
|
|
|
133
|
-
|
|
170
|
+
Pin agent versions per-project, like `package.json` for agents:
|
|
134
171
|
|
|
135
172
|
```bash
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
# An agent installing what it needs
|
|
140
|
-
relay install @tools/db-migrate
|
|
141
|
-
# → {"status":"ok","agent":"db-migrate","skills":["migrate","rollback","seed"]}
|
|
173
|
+
anpm install @tools/formatter --save # adds to anpm.yaml
|
|
174
|
+
anpm install # install all from anpm.yaml
|
|
175
|
+
anpm run claude # launch with only declared agents
|
|
142
176
|
```
|
|
143
177
|
|
|
144
|
-
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## AI-Native
|
|
181
|
+
|
|
182
|
+
anpm is built for AI agents as first-class consumers. Structured JSON output, scriptable commands, and MCP server mode:
|
|
145
183
|
|
|
146
184
|
```bash
|
|
147
|
-
|
|
185
|
+
# AI agent searching for tools
|
|
186
|
+
anpm search "customer support" --json | jq '.results[].slug'
|
|
187
|
+
|
|
188
|
+
# AI agent installing what it needs
|
|
189
|
+
anpm install @acme/support-bot --json
|
|
190
|
+
# → {"status":"ok","slug":"@acme/support-bot","version":"1.0.0",...}
|
|
191
|
+
|
|
192
|
+
# MCP server mode
|
|
193
|
+
anpm mcp
|
|
148
194
|
```
|
|
149
195
|
|
|
150
196
|
---
|
|
151
197
|
|
|
152
|
-
##
|
|
198
|
+
## Supported Platforms
|
|
199
|
+
|
|
200
|
+
### Local Harnesses
|
|
201
|
+
|
|
202
|
+
| Harness | Skills | Rules | Commands | Agents |
|
|
203
|
+
|---|---|---|---|---|
|
|
204
|
+
| Claude Code | ✅ | ✅ | ✅ | ✅ |
|
|
205
|
+
| Cursor | ✅ | ✅ | ✅ | ✅ |
|
|
206
|
+
| Codex | ✅ | ✅ | ✅ | ✅ |
|
|
207
|
+
| Gemini CLI | ✅ | ✅ | ✅ | ✅ |
|
|
208
|
+
| Windsurf | ✅ | ✅ | ✅ | ✅ |
|
|
209
|
+
| Cline | ✅ | ✅ | ✅ | ✅ |
|
|
210
|
+
| RooCode | ✅ | ✅ | ✅ | ✅ |
|
|
211
|
+
| OpenCode | ✅ | ✅ | ✅ | ✅ |
|
|
212
|
+
|
|
213
|
+
### Cloud Providers
|
|
214
|
+
|
|
215
|
+
| Provider | Deploy | Status |
|
|
216
|
+
|---|---|---|
|
|
217
|
+
| Anthropic Managed Agents | ✅ | Available |
|
|
218
|
+
| OpenAI | — | Planned |
|
|
219
|
+
| Google | — | Planned |
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## Open Source
|
|
153
224
|
|
|
154
|
-
The CLI and agent spec are open source (MIT). Build agents, publish them, self-host
|
|
225
|
+
The CLI and agent spec are open source (MIT). Build agents, publish them, self-host — no vendor lock-in.
|
|
155
226
|
|
|
156
|
-
[
|
|
157
|
-
-
|
|
158
|
-
-
|
|
227
|
+
[anpm.io](https://anpm.io) provides the hosted registry with:
|
|
228
|
+
- Agent marketplace and discovery
|
|
229
|
+
- Private agent hosting for organizations
|
|
159
230
|
- Usage analytics dashboard
|
|
160
|
-
-
|
|
231
|
+
- Cloud deployment to Anthropic Managed Agents
|
|
161
232
|
|
|
162
233
|
---
|
|
163
234
|
|
|
164
|
-
##
|
|
235
|
+
## Links
|
|
165
236
|
|
|
166
|
-
- [
|
|
167
|
-
- [
|
|
168
|
-
- [
|
|
237
|
+
- [anpm.io](https://anpm.io) — Registry and dashboard
|
|
238
|
+
- [Getting Started](https://anpm.io/getting-started) — Step-by-step guide
|
|
239
|
+
- [npm package](https://www.npmjs.com/package/anpm-io)
|
|
169
240
|
|
|
170
241
|
---
|
|
171
242
|
|
|
172
243
|
<p align="center">
|
|
173
|
-
<sub>
|
|
244
|
+
<sub>MIT License</sub>
|
|
174
245
|
</p>
|
package/dist/commands/update.js
CHANGED
|
@@ -75,8 +75,8 @@ function registerUpdate(program) {
|
|
|
75
75
|
const owner = parsedSlug?.owner ?? 'unknown';
|
|
76
76
|
const name = parsedSlug?.name ?? slug;
|
|
77
77
|
const agentDir = currentScope === 'global'
|
|
78
|
-
? path_1.default.join(os_1.default.homedir(), '.
|
|
79
|
-
: path_1.default.join(projectPath, '.
|
|
78
|
+
? path_1.default.join(os_1.default.homedir(), '.anpm', 'agents', owner, name)
|
|
79
|
+
: path_1.default.join(projectPath, '.anpm', 'agents', owner, name);
|
|
80
80
|
// Download & extract: prefer git, fallback to tar.gz
|
|
81
81
|
if (agent.git_url && fs_1.default.existsSync(path_1.default.join(agentDir, '.git'))) {
|
|
82
82
|
// Existing git clone — fetch + checkout latest tag
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "anpm-io",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "anpm — the agent package manager",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"bin": {
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"claude",
|
|
27
27
|
"llm",
|
|
28
28
|
"ai-agent",
|
|
29
|
-
"
|
|
29
|
+
"anpm-io",
|
|
30
30
|
"anpm",
|
|
31
31
|
"agent-npm",
|
|
32
32
|
"package-manager"
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"license": "MIT",
|
|
35
35
|
"repository": {
|
|
36
36
|
"type": "git",
|
|
37
|
-
"url": "https://github.com/
|
|
37
|
+
"url": "https://github.com/anpm-io/anpm"
|
|
38
38
|
},
|
|
39
39
|
"homepage": "https://anpm.io",
|
|
40
40
|
"dependencies": {
|