agentsrc 0.1.0 → 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 +52 -34
  2. package/dist/index.js +2351 -143
  3. package/package.json +3 -2
package/README.md CHANGED
@@ -1,17 +1,18 @@
1
1
  # agentsrc
2
2
 
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.
3
+ Keep your agent skills and MCP servers in one configuration file.
5
4
 
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.
5
+ ## Supported Agents
6
+
7
+ | Agent | Skills | MCP Servers | Usage |
8
+ | ----------- | ------ | ----------- | ----- |
9
+ | Claude Code | ✅ | ✅ | ✅ |
10
+ | Codex | ✅ | ✅ | ✅ |
11
+ | OpenCode v2 | ✅ | ✅ | ✅ |
11
12
 
12
13
  ## Installation
13
14
 
14
- Install with npm (Node 20 or later):
15
+ With npm (Node.js 20.12 or later):
15
16
 
16
17
  ```bash
17
18
  npm install -g agentsrc
@@ -23,12 +24,11 @@ Or install a standalone binary with [mise](https://mise.jdx.dev):
23
24
  mise use -g github:gerardbalaoro/agentsrc
24
25
  ```
25
26
 
26
- The examples use `arc`. Mise installations also provide `agents` and `agentsrc`; npm installations
27
- provide `arc` and `agentsrc`.
27
+ Both provide the `arc` command.
28
28
 
29
- ## Getting Started
29
+ ## Quick Start
30
30
 
31
- Initialize your project, then add a skill and an MCP server:
31
+ Run these commands from your project directory and follow the prompts:
32
32
 
33
33
  ```bash
34
34
  arc init
@@ -36,42 +36,40 @@ arc skills add vercel-labs/agent-skills
36
36
  arc mcp add npm:@upstash/context7-mcp
37
37
  ```
38
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:
43
-
44
- ```bash
45
- arc sync
46
- ```
47
-
48
- If you imported existing entries with `init`, use `arc sync --force` to let agentsrc manage those
49
- entries.
39
+ The selected skills and Context7 MCP server are now installed for your coding agents.
50
40
 
51
41
  ## Configuration
52
42
 
53
- The manifest at `.agents/agents.toml` describes your project's setup:
43
+ The configuration file lives in `.agents/agents.toml`, and typically looks like:
54
44
 
55
45
  ```toml
56
46
  agents = ["claude-code", "codex", "opencode"]
57
47
 
58
48
  [skills]
59
- frontend-design = "vercel-labs/agent-skills"
49
+ web-design-guidelines = "vercel-labs/agent-skills"
60
50
 
61
51
  [mcp.context7]
62
52
  package = "npm:@upstash/context7-mcp"
63
53
  ```
64
54
 
65
- Use `arc init -g` for personal configuration at `~/.agents/agents.toml`. Add `-g` to subsequent
66
- commands to manage that setup.
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.
67
57
 
68
- To reuse a team configuration, add `extends` at the top of your manifest:
58
+ ### Global Scope
69
59
 
70
- ```toml
71
- extends = ["https://example.com/team/agents.toml"]
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
72
67
  ```
73
68
 
74
- ## Everyday Commands
69
+ Project and global configuration are managed separately. Project configuration does not
70
+ automatically inherit global configuration.
71
+
72
+ ## Common Commands
75
73
 
76
74
  | Task | Skills | MCP Servers |
77
75
  | ------ | ------------------------------ | ------------------------------ |
@@ -80,7 +78,27 @@ extends = ["https://example.com/team/agents.toml"]
80
78
  | Update | `arc skills update [names...]` | `arc mcp update [names...]` |
81
79
  | Remove | `arc skills remove <names...>` | `arc mcp remove <names...>` |
82
80
 
83
- See the [usage guide](docs/usage.md) for import options, configuration examples, and command
84
- behavior. Run `arc --help` to explore the CLI.
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
85
103
 
86
- For development and release instructions, see [Contributing](CONTRIBUTING.md).
104
+ [AGPL-3.0](LICENSE).