agentsrc 0.0.1 → 0.1.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 +76 -5
- package/dist/index.js +38715 -2
- package/package.json +55 -10
package/README.md
CHANGED
|
@@ -1,15 +1,86 @@
|
|
|
1
1
|
# agentsrc
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Manage agent skills and MCP servers for Claude Code, Codex, and OpenCode v2 from one configuration
|
|
4
|
+
file. Share your project's setup with your team, or keep a personal setup across projects.
|
|
5
|
+
|
|
6
|
+
- Add skills and MCP servers once and use them across your coding agents.
|
|
7
|
+
- Import the skills and servers you already use.
|
|
8
|
+
- Reuse shared configuration with local files or URLs.
|
|
9
|
+
- Use skills from the [skills.sh ecosystem](https://github.com/vercel-labs/skills) with a compatible
|
|
10
|
+
lock file.
|
|
11
|
+
|
|
12
|
+
## Installation
|
|
13
|
+
|
|
14
|
+
Install with npm (Node 20 or later):
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
npm install -g agentsrc
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Or install a standalone binary with [mise](https://mise.jdx.dev):
|
|
4
21
|
|
|
5
22
|
```bash
|
|
6
|
-
|
|
23
|
+
mise use -g github:gerardbalaoro/agentsrc
|
|
7
24
|
```
|
|
8
25
|
|
|
9
|
-
|
|
26
|
+
The examples use `arc`. Mise installations also provide `agents` and `agentsrc`; npm installations
|
|
27
|
+
provide `arc` and `agentsrc`.
|
|
28
|
+
|
|
29
|
+
## Getting Started
|
|
30
|
+
|
|
31
|
+
Initialize your project, then add a skill and an MCP server:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
arc init
|
|
35
|
+
arc skills add vercel-labs/agent-skills
|
|
36
|
+
arc mcp add npm:@upstash/context7-mcp
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
`init` detects your coding agents and offers to import existing skills and servers. The `add`
|
|
40
|
+
commands save your choices in `.agents/agents.toml` and install them for your configured agents.
|
|
41
|
+
|
|
42
|
+
For a project that already has a manifest, install its skills and servers with:
|
|
10
43
|
|
|
11
44
|
```bash
|
|
12
|
-
|
|
45
|
+
arc sync
|
|
13
46
|
```
|
|
14
47
|
|
|
15
|
-
|
|
48
|
+
If you imported existing entries with `init`, use `arc sync --force` to let agentsrc manage those
|
|
49
|
+
entries.
|
|
50
|
+
|
|
51
|
+
## Configuration
|
|
52
|
+
|
|
53
|
+
The manifest at `.agents/agents.toml` describes your project's setup:
|
|
54
|
+
|
|
55
|
+
```toml
|
|
56
|
+
agents = ["claude-code", "codex", "opencode"]
|
|
57
|
+
|
|
58
|
+
[skills]
|
|
59
|
+
frontend-design = "vercel-labs/agent-skills"
|
|
60
|
+
|
|
61
|
+
[mcp.context7]
|
|
62
|
+
package = "npm:@upstash/context7-mcp"
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Use `arc init -g` for personal configuration at `~/.agents/agents.toml`. Add `-g` to subsequent
|
|
66
|
+
commands to manage that setup.
|
|
67
|
+
|
|
68
|
+
To reuse a team configuration, add `extends` at the top of your manifest:
|
|
69
|
+
|
|
70
|
+
```toml
|
|
71
|
+
extends = ["https://example.com/team/agents.toml"]
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Everyday Commands
|
|
75
|
+
|
|
76
|
+
| Task | Skills | MCP Servers |
|
|
77
|
+
| ------ | ------------------------------ | ------------------------------ |
|
|
78
|
+
| Add | `arc skills add <source>` | `arc mcp add <package or URL>` |
|
|
79
|
+
| List | `arc skills list` | `arc mcp list` |
|
|
80
|
+
| Update | `arc skills update [names...]` | `arc mcp update [names...]` |
|
|
81
|
+
| Remove | `arc skills remove <names...>` | `arc mcp remove <names...>` |
|
|
82
|
+
|
|
83
|
+
See the [usage guide](docs/usage.md) for import options, configuration examples, and command
|
|
84
|
+
behavior. Run `arc --help` to explore the CLI.
|
|
85
|
+
|
|
86
|
+
For development and release instructions, see [Contributing](CONTRIBUTING.md).
|