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.
Files changed (3) hide show
  1. package/README.md +94 -5
  2. package/dist/index.js +40923 -2
  3. package/package.json +56 -10
package/README.md CHANGED
@@ -1,15 +1,104 @@
1
1
  # agentsrc
2
2
 
3
- To install dependencies:
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
- bun install
18
+ npm install -g agentsrc
7
19
  ```
8
20
 
9
- To run:
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
- bun run index.ts
34
+ arc init
35
+ arc skills add vercel-labs/agent-skills
36
+ arc mcp add npm:@upstash/context7-mcp
13
37
  ```
14
38
 
15
- This project was created using `bun init` in bun v1.3.14. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
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).