A plugin manager for AI coding agents. Short iteration loops for local plugin development and version-controlled plugin management across Claude, Codex, and Cursor.
The name comes from the Korean word "집사", a butler or caretaker: a tool that quietly manages your agent plugins for you.
AI agent plugins (skills, commands, agents) are just files — but there's no npm or brew for them. You end up manually copying directories, losing track of versions, and context-switching between platforms.
Zipsa gives you:
- Fast dev loops — edit a local plugin, and every agent sees the change instantly via symlinks. No rebuild, no reinstall.
- Version tracking — remote plugins are Git clones.
zipsa syncpulls updates.zipsa diffshows what changed. You always know what version you're running. - One config, multiple targets — a single
zipsa.yamldeclares which plugins go to which platforms.
Requires Deno.
# Install globally
deno install --global --name zipsa \
--allow-env --allow-read --allow-write --allow-run main.ts
# Or compile to a standalone binary
deno task compile
sudo cp zipsa /usr/local/bin/zipsa setup # Initialize config
zipsa init my-skill # Scaffold a new plugin
zipsa install ~/personal/my-skill # Register local plugin
zipsa install https://github.com/obra/superpowers # Or install from Git
zipsa apply --all # Link everything to targets
zipsa status # See what's installed and wherezipsa init my-skill # Scaffold plugin structure
zipsa install . # Register from current directory
# Edit skills/, commands/, agents/ — changes are live immediately
zipsa status # Verify links are intactzipsa install https://github.com/user/plugin # Clone and apply
zipsa diff plugin-name # See upstream changes
zipsa sync plugin-name # Pull latest
zipsa sync # Sync all remote plugins| Command | Description |
|---|---|
setup |
Create config directory and default zipsa.yaml |
init <name> |
Scaffold a new plugin project |
install <source> |
Install from Git URL or local path |
apply . | --all |
Apply current or all plugins to targets |
sync [name] |
Pull updates for remote plugins |
remove <name> |
Remove plugin and clean up symlinks |
status |
Show installation, link, and git status |
diff <name> |
Show uncommitted or upstream changes |
list |
List installed plugins with versions |
~/.config/zipsa/zipsa.yaml:
targets:
claude: ~/.claude/plugins
codex: ~/.codex/plugins
cursor: ~/.cursor/plugins
plugins:
superpowers:
source: https://github.com/obra/superpowers
targets: [claude, codex]
my-skill:
source: ~/personal/my-skill
targets: [claude]my-plugin/
├── .claude-plugin/plugin.json
├── .codex-plugin/plugin.json
├── skills/
├── commands/
├── agents/
└── README.md
deno task dev # Run with file watcher
deno task test # Run tests
deno task compile # Build binaryMIT
