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.
Files changed (3) hide show
  1. package/README.md +76 -5
  2. package/dist/index.js +38715 -2
  3. package/package.json +55 -10
package/README.md CHANGED
@@ -1,15 +1,86 @@
1
1
  # agentsrc
2
2
 
3
- To install dependencies:
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
- bun install
23
+ mise use -g github:gerardbalaoro/agentsrc
7
24
  ```
8
25
 
9
- To run:
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
- bun run index.ts
45
+ arc sync
13
46
  ```
14
47
 
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.
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).