@swarmify/agents-cli 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+## 1.5.0
+
+**Pull command redesign**
+
+- Agent-specific sync: `agents pull claude` syncs only Claude resources
+- Agent aliases: `cc`, `cx`, `gx`, `cr`, `oc` for quick filtering
+- Overview display: Shows NEW vs EXISTING resources before installation
+- Per-resource prompts: Choose overwrite/skip/cancel for each conflict
+- `-y` flag: Auto-confirm and skip conflicts
+- `-f` flag: Auto-confirm and overwrite conflicts
+- Graceful cancellation: Ctrl+C shows "Cancelled" cleanly
+
+## 1.4.0
+
+- Conflict detection for pull command
+- Bulk conflict handling (overwrite all / skip all / cancel)
+
+## 1.3.13
+
+- Enabled skills support for Cursor and OpenCode
+- Fixed Cursor MCP config path (now uses mcp.json)
+
+## 1.3.12
+
+- Fixed MCP detection for Codex (TOML config format)
+- Fixed MCP detection for OpenCode (JSONC config format)
+- Added smol-toml dependency for TOML parsing
+
+## 1.3.11
+
+- Status command shows resource names instead of counts
+- Better formatting for installed commands, skills, and MCPs
+
+## 1.3.0
+
+- Added Agent Skills support (SKILL.md + rules/)
+- Skills validation with metadata requirements
+- Central skills directory at ~/.agents/skills/
+
+## 1.2.0
+
+- Added hooks support for Claude and Gemini
+- Hook discovery from shared/ and agent-specific directories
+- Project-scope hooks support
+
+## 1.1.0
+
+- Added MCP server registration
+- Support for stdio and http transports
+- Per-agent MCP configuration
+
+## 1.0.0
+
+- Initial release
+- Pull/push commands for syncing agent configurations
+- Slash command management
+- Multi-agent support (Claude, Codex, Gemini, Cursor, OpenCode)

package/README.md

@@ -12,14 +12,14 @@ You spend hours configuring Claude Code: MCP servers, slash commands, hooks, ski
 
 ## The Solution
 
-Keep your agent configuration in a git repo. Pull it anywhere.
+One command to configure all your agents.
 
 ```bash
 # New machine? One command.
-agents pull gh:username/.agents
+agents pull
 
 # See what's installed
-agents status claude
+agents status
 ```
 
 ```
@@ -62,17 +62,33 @@ Your `.agents` repo becomes the source of truth for all your AI coding tools.
 # 1. Install
 npm install -g @swarmify/agents-cli
 
-# 2. Set your config repo
-agents repo add gh:username/.agents
-
-# 3. Pull everything
+# 2. Pull (auto-configures from default repo on first run)
 agents pull
 
-# 4. Check what's installed
+# 3. Check what's installed
 agents status
 ```
 
-## Your .agents Repo
+Pull a specific agent only:
+
+```bash
+agents pull claude    # Only configure Claude Code
+agents pull codex     # Only configure Codex
+```
+
+## Using Your Own Config
+
+By default, `agents pull` uses the [system repo](https://github.com/muqsitnawaz/.agents). To use your own:
+
+```bash
+# Fork the system repo, then:
+agents repo add gh:username/.agents
+
+# Now pull uses your repo
+agents pull
+```
+
+## .agents Repo Structure
 
 ```
 .agents/
@@ -127,11 +143,17 @@ agents status --agent claude
 ### Pull & Push
 
 ```bash
-agents pull                # Sync from your repo
-agents pull --dry-run      # Preview changes
+agents pull                # Sync all agents from your repo
+agents pull claude         # Sync only Claude resources
+agents pull cc             # Same (aliases: cc, codex/cx, gemini/gx)
+agents pull --dry-run      # Preview what would change
+agents pull -y             # Auto-confirm, skip conflicts
+agents pull -f             # Auto-confirm, overwrite conflicts
 agents push                # Push local changes back
 ```
 
+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.
+
 ### Slash Commands
 
 ```bash