agent-mgr 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 +113 -0
- package/dist/index.js +1477 -0
- package/package.json +47 -0
package/README.md
ADDED
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# agent-mgr
|
|
2
|
+
|
|
3
|
+
Manage AI agent commands, prompts, and MCP configs from one place. Write a command once, sync it to Claude Code, Cursor, Codex, and OpenCode.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g agent-mgr
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Or use directly:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npx agent-mgr init
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Quick start
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
amgr init # pick your platforms
|
|
21
|
+
amgr add review # create a command
|
|
22
|
+
# edit commands/review.md
|
|
23
|
+
amgr sync # symlink to all platforms
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Your command is now available as `/review` in Claude Code, Cursor, etc.
|
|
27
|
+
|
|
28
|
+
## What it does
|
|
29
|
+
|
|
30
|
+
You maintain commands in a `commands/` directory. `amgr sync` creates symlinks into each platform's expected location (`.claude/commands/`, `.cursor/prompts/`, etc.). Edit the source, every platform stays in sync.
|
|
31
|
+
|
|
32
|
+
## Commands
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
amgr init Setup (interactive or with flags)
|
|
36
|
+
amgr init --all --gitignore All platforms, gitignore generated dirs
|
|
37
|
+
|
|
38
|
+
amgr add <name> Create command template
|
|
39
|
+
amgr add <name> --from <file> Import from existing .md
|
|
40
|
+
amgr add <name> --content "..." Inline content
|
|
41
|
+
amgr remove <name> Delete command + synced copies
|
|
42
|
+
amgr sync Distribute to all platforms
|
|
43
|
+
amgr list Show commands and sync status
|
|
44
|
+
|
|
45
|
+
amgr profile create <name> Named command sets
|
|
46
|
+
amgr profile switch <name> Activate a profile
|
|
47
|
+
amgr profile list Show profiles
|
|
48
|
+
amgr profile delete <name> Delete a profile
|
|
49
|
+
|
|
50
|
+
amgr sync-repo add <url> Import commands from a GitHub repo
|
|
51
|
+
amgr sync-repo update Pull latest from tracked repos
|
|
52
|
+
amgr sync-repo list Show tracked repos
|
|
53
|
+
amgr sync-repo remove <url> Stop tracking
|
|
54
|
+
|
|
55
|
+
amgr mcp add Add MCP server config (interactive)
|
|
56
|
+
amgr mcp remove <name> Remove from all platforms
|
|
57
|
+
amgr mcp list Show MCP servers per platform
|
|
58
|
+
|
|
59
|
+
amgr hook install Auto-sync on git checkout/merge
|
|
60
|
+
amgr hook remove Remove hooks
|
|
61
|
+
|
|
62
|
+
amgr help Detailed help
|
|
63
|
+
amgr help-agent Output reference for AI agents
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## Command priority
|
|
67
|
+
|
|
68
|
+
When syncing, commands merge from three sources. Higher priority wins when filenames collide:
|
|
69
|
+
|
|
70
|
+
1. **Project** (`commands/`)
|
|
71
|
+
2. **Profile** (`~/.agent-mgr/profiles/<name>/commands/`)
|
|
72
|
+
3. **Global** (`~/.agent-mgr/commands/`)
|
|
73
|
+
|
|
74
|
+
## Supported platforms
|
|
75
|
+
|
|
76
|
+
| Platform | Commands | MCP |
|
|
77
|
+
|----------|----------|-----|
|
|
78
|
+
| Claude Code | `.claude/commands/` | `.claude/mcp.json` |
|
|
79
|
+
| Cursor | `.cursor/prompts/` | `.cursor/mcp.json` |
|
|
80
|
+
| Codex | - | `.codex/mcp.json` |
|
|
81
|
+
| OpenCode | - | `opencode.json` |
|
|
82
|
+
|
|
83
|
+
## Command format
|
|
84
|
+
|
|
85
|
+
```markdown
|
|
86
|
+
---
|
|
87
|
+
description: What this command does
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
Your prompt here.
|
|
91
|
+
|
|
92
|
+
$ARGUMENTS
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
`$ARGUMENTS` is replaced with whatever the user types after the slash command.
|
|
96
|
+
|
|
97
|
+
## Config files
|
|
98
|
+
|
|
99
|
+
```
|
|
100
|
+
.agent-mgr.yml Project config (targets)
|
|
101
|
+
~/.agent-mgr/config.yml Global config
|
|
102
|
+
~/.agent-mgr/commands/ Global commands
|
|
103
|
+
~/.agent-mgr/profiles/ Named profiles
|
|
104
|
+
~/.agent-mgr/repos/ Cached repo clones
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Works with AI agents
|
|
108
|
+
|
|
109
|
+
Run `amgr help-agent` to get a reference prompt you can give to your AI agent. It will understand the tool and help you configure it.
|
|
110
|
+
|
|
111
|
+
## License
|
|
112
|
+
|
|
113
|
+
MIT
|