agentsrc 0.0.1 → 0.2.0
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 +94 -5
- package/dist/index.js +40923 -2
- package/package.json +56 -10
package/README.md
CHANGED
|
@@ -1,15 +1,104 @@
|
|
|
1
1
|
# agentsrc
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Keep your agent skills and MCP servers in one configuration file.
|
|
4
|
+
|
|
5
|
+
## Supported Agents
|
|
6
|
+
|
|
7
|
+
| Agent | Skills | MCP Servers | Usage |
|
|
8
|
+
| ----------- | ------ | ----------- | ----- |
|
|
9
|
+
| Claude Code | ✅ | ✅ | ✅ |
|
|
10
|
+
| Codex | ✅ | ✅ | ✅ |
|
|
11
|
+
| OpenCode v2 | ✅ | ✅ | ✅ |
|
|
12
|
+
|
|
13
|
+
## Installation
|
|
14
|
+
|
|
15
|
+
With npm (Node.js 20.12 or later):
|
|
4
16
|
|
|
5
17
|
```bash
|
|
6
|
-
|
|
18
|
+
npm install -g agentsrc
|
|
7
19
|
```
|
|
8
20
|
|
|
9
|
-
|
|
21
|
+
Or install a standalone binary with [mise](https://mise.jdx.dev):
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
mise use -g github:gerardbalaoro/agentsrc
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Both provide the `arc` command.
|
|
28
|
+
|
|
29
|
+
## Quick Start
|
|
30
|
+
|
|
31
|
+
Run these commands from your project directory and follow the prompts:
|
|
10
32
|
|
|
11
33
|
```bash
|
|
12
|
-
|
|
34
|
+
arc init
|
|
35
|
+
arc skills add vercel-labs/agent-skills
|
|
36
|
+
arc mcp add npm:@upstash/context7-mcp
|
|
13
37
|
```
|
|
14
38
|
|
|
15
|
-
|
|
39
|
+
The selected skills and Context7 MCP server are now installed for your coding agents.
|
|
40
|
+
|
|
41
|
+
## Configuration
|
|
42
|
+
|
|
43
|
+
The configuration file lives in `.agents/agents.toml`, and typically looks like:
|
|
44
|
+
|
|
45
|
+
```toml
|
|
46
|
+
agents = ["claude-code", "codex", "opencode"]
|
|
47
|
+
|
|
48
|
+
[skills]
|
|
49
|
+
web-design-guidelines = "vercel-labs/agent-skills"
|
|
50
|
+
|
|
51
|
+
[mcp.context7]
|
|
52
|
+
package = "npm:@upstash/context7-mcp"
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Use `extends` to share configuration from local files or URLs. See the
|
|
56
|
+
[configuration overview](docs/configuration.md) for scope, agent selection, and inheritance.
|
|
57
|
+
|
|
58
|
+
### Global Scope
|
|
59
|
+
|
|
60
|
+
Use the `-g` flag to manage `~/.agents/agents.toml` and install skills and servers for use across
|
|
61
|
+
projects:
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
arc init -g
|
|
65
|
+
arc skills add vercel-labs/agent-skills -g
|
|
66
|
+
arc sync -g
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Project and global configuration are managed separately. Project configuration does not
|
|
70
|
+
automatically inherit global configuration.
|
|
71
|
+
|
|
72
|
+
## Common Commands
|
|
73
|
+
|
|
74
|
+
| Task | Skills | MCP Servers |
|
|
75
|
+
| ------ | ------------------------------ | ------------------------------ |
|
|
76
|
+
| Add | `arc skills add <source>` | `arc mcp add <package or URL>` |
|
|
77
|
+
| List | `arc skills list` | `arc mcp list` |
|
|
78
|
+
| Update | `arc skills update [names...]` | `arc mcp update [names...]` |
|
|
79
|
+
| Remove | `arc skills remove <names...>` | `arc mcp remove <names...>` |
|
|
80
|
+
|
|
81
|
+
You can also check subscription allowances for your signed-in accounts:
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
arc usage
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
See [account limits](docs/account-limits.md) for account support and banked resets.
|
|
88
|
+
|
|
89
|
+
## Documentation
|
|
90
|
+
|
|
91
|
+
- [Configuration](docs/configuration.md): manifest structure, scope, agent selection, sharing, and
|
|
92
|
+
CI.
|
|
93
|
+
- [Skills](docs/skills.md): imports, sources, configuration, commands, and Vercel Skills CLI
|
|
94
|
+
compatibility.
|
|
95
|
+
- [MCP servers](docs/mcp.md): imports, configuration, authentication, commands, and agent
|
|
96
|
+
compatibility.
|
|
97
|
+
- [Account limits](docs/account-limits.md): allowances, authentication, and reset claims.
|
|
98
|
+
- [Contributing](CONTRIBUTING.md): development and releases.
|
|
99
|
+
|
|
100
|
+
Run `arc --help` or `arc <command> --help` for command options.
|
|
101
|
+
|
|
102
|
+
## License
|
|
103
|
+
|
|
104
|
+
[AGPL-3.0](LICENSE).
|