Install, version, update, and rollback skills across OpenCode, Claude, and Codex — from a single CLI.
npm package: @callmeradical/augy
· CLI command: augy
AI agents load skills from local directories. augy brings the discipline of a package manager to that chaos.
Every install tracks the exact GitHub commit SHA. Drift is detected the moment upstream changes.
Before overwriting, augy snapshots the current version. Roll back to any point in history.
Auto-detects which agents are on your machine. Deploy one skill to all of them — they update together.
Register trusted repos. Then augy install tdd — no URL needed.
Interactive file-level diffs between any two versions. Know exactly what changed before upgrading.
Skills already on disk? Scan detects them, auto-discovers provenance, and brings them under management.
augy bundle creates an augy.json manifest. Commit it. Teammates run augy sync.
npm install -g @callmeradical/augy
Adds the augy command to your PATH.
augy tap add mattpocock/skills
augy install tdd
If you've been installing skills manually, augy can find and import them:
augy scan # finds untracked skills, detects provenance
All commands support --help for inline documentation.
Install skills from a GitHub URL, shorthand, or bare name via taps. Shows a filterable multi-select when a repo contains multiple skills.
augy install tdd augy install mattpocock/skills augy install https://github.com/org/repo/tree/main augy install tdd --agent opencode claude
Walk all agent skill directories, find untracked skills, auto-detect provenance via git remotes and frontmatter, then import them into the registry.
augy scan
Check all installed skills for upstream SHA drift, show available upgrades, archive the current version, then deploy the new one.
augy update augy update tdd
Interactive file-level diff browser. Three modes: installed vs upstream, installed vs a specific SHA, or two local archives.
augy diff tdd augy diff tdd abc1234 augy diff tdd abc1234 def5678
Restore a skill to a previously archived version. Without a SHA, presents an interactive picker of available snapshots.
augy rollback tdd augy rollback tdd abc1234
Show all installed skills with SHAs, agents, update timestamps, and version history counts.
augy list augy list --json # raw registry JSON
Full metadata view: source, tap, SHA, install/update dates, per-agent paths with existence check, version history, and SKILL.md description preview.
augy info tdd
Search all registered taps for available skills. Shows each skill's SHA and whether it's installed and up to date.
augy search augy search tdd
Manage trusted repos. Once tapped, skills can be installed by bare name. Validated on add by fetching the skill index.
augy tap add mattpocock/skills augy tap add org/repo --path skills/engineering augy tap list augy tap remove mattpocock/skills
Write an augy.json manifest from installed skills. Commit it so teammates can reproduce your exact skill set.
augy bundle augy bundle --output ~/team/augy.json augy bundle --include-untracked
// augy.json { "version": 1, "skills": { "tdd": "mattpocock/skills/skills/engineering/tdd", "commit": "org/repo/skills/commit" } }
Install and update skills from an augy.json manifest. Skills not in the manifest are left alone — nothing is auto-removed.
augy sync augy sync ~/team/augy.json augy sync --dry-run # preview only augy sync --agent opencode claude
Attach a GitHub URL to a skill imported without one. Accepts tree and blob URLs. Enables updates, diffs, and rollbacks going forward.
augy set-source commit https://github.com/org/repo/tree/main/skills/commit
Remove a skill from all agent paths and the registry. Optionally prune archived versions from the version store.
augy uninstall tdd
Pin a skill to freeze it at the current version, skipping it during augy update.
augy pin tdd augy unpin tdd
augy auto-detects which agents are installed on your machine and pre-selects them in the install prompt. A single skill can be deployed to multiple agents simultaneously.
augy stores all state in a single human-readable JSON lockfile at ~/.augy/registry.json. You can read, diff, and commit it just like any other config file.
Version archives are stored as plain directory snapshots — no binary formats, no databases.
| Variable | Default | Description |
|---|---|---|
| AUGY_HOME | ~/.augy | Override augy's home directory |
| CODEX_HOME | ~/.codex | Override Codex agent path |
| GITHUB_TOKEN | — | Raise GitHub API rate limit from 60 → 5,000 req/hr |