@swarmify/agents-cli 1.4.0 → 1.5.1

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/CHANGELOG.md ADDED
@@ -0,0 +1,67 @@
1
+ # Changelog
2
+
3
+ ## 1.5.1
4
+
5
+ - Update check: Shows prompt when new version available
6
+ - What's new: Displays changelog after upgrade
7
+ - `skills view`: Interactive skill selector (renamed from `info`)
8
+ - Fixed `--version` showing hardcoded 1.0.0 (now reads from package.json)
9
+ - Silent npm/bun output during upgrade
10
+
11
+ ## 1.5.0
12
+
13
+ **Pull command redesign**
14
+
15
+ - Agent-specific sync: `agents pull claude` syncs only Claude resources
16
+ - Agent aliases: `cc`, `cx`, `gx`, `cr`, `oc` for quick filtering
17
+ - Overview display: Shows NEW vs EXISTING resources before installation
18
+ - Per-resource prompts: Choose overwrite/skip/cancel for each conflict
19
+ - `-y` flag: Auto-confirm and skip conflicts
20
+ - `-f` flag: Auto-confirm and overwrite conflicts
21
+ - Graceful cancellation: Ctrl+C shows "Cancelled" cleanly
22
+
23
+ ## 1.4.0
24
+
25
+ - Conflict detection for pull command
26
+ - Bulk conflict handling (overwrite all / skip all / cancel)
27
+
28
+ ## 1.3.13
29
+
30
+ - Enabled skills support for Cursor and OpenCode
31
+ - Fixed Cursor MCP config path (now uses mcp.json)
32
+
33
+ ## 1.3.12
34
+
35
+ - Fixed MCP detection for Codex (TOML config format)
36
+ - Fixed MCP detection for OpenCode (JSONC config format)
37
+ - Added smol-toml dependency for TOML parsing
38
+
39
+ ## 1.3.11
40
+
41
+ - Status command shows resource names instead of counts
42
+ - Better formatting for installed commands, skills, and MCPs
43
+
44
+ ## 1.3.0
45
+
46
+ - Added Agent Skills support (SKILL.md + rules/)
47
+ - Skills validation with metadata requirements
48
+ - Central skills directory at ~/.agents/skills/
49
+
50
+ ## 1.2.0
51
+
52
+ - Added hooks support for Claude and Gemini
53
+ - Hook discovery from shared/ and agent-specific directories
54
+ - Project-scope hooks support
55
+
56
+ ## 1.1.0
57
+
58
+ - Added MCP server registration
59
+ - Support for stdio and http transports
60
+ - Per-agent MCP configuration
61
+
62
+ ## 1.0.0
63
+
64
+ - Initial release
65
+ - Pull/push commands for syncing agent configurations
66
+ - Slash command management
67
+ - Multi-agent support (Claude, Codex, Gemini, Cursor, OpenCode)
package/README.md CHANGED
@@ -12,14 +12,14 @@ You spend hours configuring Claude Code: MCP servers, slash commands, hooks, ski
12
12
 
13
13
  ## The Solution
14
14
 
15
- Keep your agent configuration in a git repo. Pull it anywhere.
15
+ One command to configure all your agents.
16
16
 
17
17
  ```bash
18
18
  # New machine? One command.
19
- agents pull gh:username/.agents
19
+ agents pull
20
20
 
21
21
  # See what's installed
22
- agents status claude
22
+ agents status
23
23
  ```
24
24
 
25
25
  ```
@@ -62,17 +62,33 @@ Your `.agents` repo becomes the source of truth for all your AI coding tools.
62
62
  # 1. Install
63
63
  npm install -g @swarmify/agents-cli
64
64
 
65
- # 2. Set your config repo
66
- agents repo add gh:username/.agents
67
-
68
- # 3. Pull everything
65
+ # 2. Pull (auto-configures from default repo on first run)
69
66
  agents pull
70
67
 
71
- # 4. Check what's installed
68
+ # 3. Check what's installed
72
69
  agents status
73
70
  ```
74
71
 
75
- ## Your .agents Repo
72
+ Pull a specific agent only:
73
+
74
+ ```bash
75
+ agents pull claude # Only configure Claude Code
76
+ agents pull codex # Only configure Codex
77
+ ```
78
+
79
+ ## Using Your Own Config
80
+
81
+ By default, `agents pull` uses the [system repo](https://github.com/muqsitnawaz/.agents). To use your own:
82
+
83
+ ```bash
84
+ # Fork the system repo, then:
85
+ agents repo add gh:username/.agents
86
+
87
+ # Now pull uses your repo
88
+ agents pull
89
+ ```
90
+
91
+ ## .agents Repo Structure
76
92
 
77
93
  ```
78
94
  .agents/
@@ -127,11 +143,17 @@ agents status --agent claude
127
143
  ### Pull & Push
128
144
 
129
145
  ```bash
130
- agents pull # Sync from your repo
131
- agents pull --dry-run # Preview changes
146
+ agents pull # Sync all agents from your repo
147
+ agents pull claude # Sync only Claude resources
148
+ agents pull cc # Same (aliases: cc, codex/cx, gemini/gx)
149
+ agents pull --dry-run # Preview what would change
150
+ agents pull -y # Auto-confirm, skip conflicts
151
+ agents pull -f # Auto-confirm, overwrite conflicts
132
152
  agents push # Push local changes back
133
153
  ```
134
154
 
155
+ The pull command shows an overview of NEW vs EXISTING resources before installation. For conflicts, you're prompted per-resource to overwrite, skip, or cancel.
156
+
135
157
  ### Slash Commands
136
158
 
137
159
  ```bash