A cross-environment agent asset manager. Install, sync, and update agent skills, instructions, and agents from the awesome-copilot catalogue into VS Code, Kiro, and Antigravity — with subscription tracking, hash-based change detection, dry-run, and local-edit protection.
Successor to vscode-copilot-sync — same lifecycle safety, now cross-environment and runtime-agnostic.
npx @ctout-uk/agentsmith sync
npx @ctout-uk/agentsmith installNo install required. Requires Node 24+.
- Syncs the awesome-copilot catalogue into a local cache (
~/.agentsmith/) - Installs assets into your environment's correct locations with frontmatter translated for each target
- Tracks every installation in
~/.agentsmith/subscriptions.jsonwith SHA-256 hashes - Detects local edits (
[~]) and upstream updates ([↑]) before touching anything - Removes only what it installed — user-created files are never touched
| Environment | Repo scope | User scope |
|---|---|---|
| VS Code (Copilot harness) | .github/agents/, .github/instructions/, .github/skills/ |
~/.copilot/agents/, ~/.copilot/instructions/, ~/.copilot/skills/ |
| Kiro | .kiro/agents/, .kiro/steering/, .kiro/skills/ |
~/.kiro/agents/, ~/.kiro/steering/, ~/.kiro/skills/ |
| Antigravity | .agents/plugins/<name>/ |
~/.gemini/config/plugins/<name>/ |
agentsmith sync # Pull latest from awesome-copilot into ~/.agentsmith/
agentsmith sync --dry-run # Preview sync without writing
agentsmith install # Interactive picker for the detected environment
agentsmith install se-security-reviewer # Install a specific asset
agentsmith install --target kiro # Target a specific environment
agentsmith install --scope user # Install at user level (available everywhere)
agentsmith install --recommended # Install all recommended assets non-interactively
agentsmith install --type instruction # Filter picker by asset type
agentsmith install --search "security" # Filter picker by search term
agentsmith install --dry-run # Preview without writing
agentsmith update # Apply upstream updates to all subscriptions
agentsmith update --target vscode # Limit to a specific environment
agentsmith update --dry-run # Preview updates
agentsmith update --force # Overwrite locally modified files
agentsmith remove # Interactive picker of installed assets to remove
agentsmith remove se-security-reviewer # Remove a specific asset
agentsmith remove --dry-run # Preview removals
agentsmith list # Show all installed assets and their status
agentsmith list --target kiro # Filter by environment
agentsmith list --scope user # Filter by scope| Badge | Meaning |
|---|---|
★ |
Recommended for this environment |
[*] |
Already installed |
[↑] |
Update available from upstream |
[~] |
Locally modified since install |
[!] |
Requires additional setup (MCP server, API key, etc.) |
Assets are translated for each target environment transparently. The adapter reports what changed:
installed 'security-and-owasp' -> kiro:repo [adapted: applyTo -> inclusion: fileMatch, fileMatchPattern: **/*.ts]
Three outcomes are possible:
- Native — asset installed as-is, no changes
- Adapted — frontmatter translated for the target; changes reported
- Unsupported — asset cannot be safely installed; reason explained
VS Code (applyTo) |
Kiro (inclusion) |
Antigravity (trigger) |
|---|---|---|
applyTo: "**/*.ts" |
inclusion: fileMatch + fileMatchPattern: "**/*.ts" |
trigger: glob + globs: "**/*.ts" |
applyTo: "**" |
inclusion: always |
trigger: always_on |
| (none) | inclusion: always |
trigger: always_on |
~/.agentsmith/
├── sources/
│ └── awesome-copilot/ # Local git checkout (sparse)
├── catalogue.json # Metadata index for the picker
├── manifest.json # Sync state (hashes, timestamps)
└── subscriptions.json # Installation records per target and scope
Migration notice: If you have an existing
~/.awesome-copilot/directory from vscode-copilot-sync, agentsmith uses a separate~/.agentsmith/cache. Runagentsmith syncto populate it fresh.
- Path traversal protection via
assertPathWithinon every file write and removal operation - Only files recorded in
subscriptions.jsonare removed — user-created files are never touched - Locally modified files are flagged
[~]and skipped without--force --dry-runis available on all write commands
See SECURITY.md for vulnerability reporting.
- Node 24+ — nodejs.org
- git — for the initial awesome-copilot clone
- awesome-copilot — the community catalogue agentsmith syncs from
- vscode-copilot-sync — the archived PowerShell predecessor
- Agent Plugins specification — portable plugin packaging standard
MIT — see LICENSE