augy

Homebrew for AI agent skills. No marketplace. No accounts. No central service. Just Git repos, a lockfile, and full control over what runs in your agents.

augy install tdd              # install by name via a tap
augy update                   # upgrade everything with upstream changes
augy diff tdd                 # browse what changed before upgrading
augy rollback tdd abc1234     # something broke — go back

---

The philosophy

Other skill managers route you through a hosted registry — a central service you have to trust, that can go down, that doesn't work with private repos, and that you can't use behind a firewall.

augy works differently. Skills are just files in Git repos. GitHub is the registry.

• Any GitHub repo is a valid skill source — public or private
• ~/.augy/registry.json is your lockfile — a plain JSON file you can read, diff, commit, and share
• No account required. No API key for the registry. No SaaS dependency
• Works in enterprise environments, behind proxies, with internal repos
• You decide which repos to trust — not a third-party curation team

The tap system is Homebrew's model: register a repo once, install skills by name. Remove the tap and you've unregistered the source. Simple, transparent, yours.

---

Install

npm install -g @callmeradical/augy

The npm package is @callmeradical/augy. The CLI command is augy.

Requires Node.js ≥ 18.

---

How it works

Skills are directories containing a SKILL.md file that an AI agent loads as context. augy tracks which skills you have installed, where they came from (a GitHub path), and what exact version (commit SHA) is on disk — then lets you update, diff, and roll back just like a package manager.

Supported agents

augy auto-detects which agents are installed on your machine and pre-selects them in the install prompt. All 33 are supported:

Claude · OpenCode · Codex · Cursor · Windsurf · GitHub Copilot · Gemini CLI · Goose · Amp · Roo Code · Cline · Kiro · Kimi CLI · Kilo Code · Trae · Trae CN · Augment · OpenHands · Replit · Crush · Antigravity · Droid · OpenClaw · CodeBuddy · Command Code · Kode · Mistral Vibe · Mux · OpenClaude IDE · Qoder · Qwen Code · Neovate · AdaL

A single skill can be deployed to multiple agents simultaneously and stays in sync on every update.

---

Quick start

# 1. Add a tap — a GitHub repo you trust
augy tap add mattpocock/skills

# 2. See what's available
augy search

# 3. Install by name
augy install tdd

# Already have skills installed manually? Bring them under augy management:
augy scan

---

Commands

augy install [url]

Install skills from a GitHub URL, owner/repo[/path] shorthand, or a bare name resolved via a tap. When a repo contains multiple skills, shows a filterable picker.

augy install tdd                                          # via tap
augy install mattpocock/skills                            # all skills in a repo
augy install https://github.com/mattpocock/skills/tree/main
augy install tdd --agent opencode claude                  # specific agents

augy scan

Walk all agent skill directories, find skills augy doesn't know about, auto-detect their GitHub source via git remotes and SKILL.md frontmatter, and import them into the registry. Skills without a detectable source show their filesystem path so you can look them up.

augy scan

augy update [skill]

Check all installed skills for upstream SHA drift. Archives the current version, then deploys the new one.

augy update              # check + upgrade everything
augy update tdd          # single skill

augy diff <skill> [sha1] [sha2]

Interactive file-level diff browser. Three modes:

augy diff tdd                    # installed ↔ upstream HEAD
augy diff tdd abc1234            # installed ↔ specific SHA
augy diff tdd abc1234 def5678    # two local archives side-by-side

augy rollback <skill> [sha]

Restore a skill to any previously archived version. Without a SHA, shows an interactive picker.

augy rollback tdd
augy rollback tdd abc1234

augy list

Show all installed skills, their SHAs, agents, and version history.

augy list
augy list --json    # raw registry JSON

augy info <skill>

Full metadata: source, SHA, agents with paths, version history, and a description preview from SKILL.md.

augy info tdd

augy search [query]

Search all registered taps for available skills. Shows install status and whether each skill is up to date.

augy search           # full index across all taps
augy search tdd       # filter by name

augy tap add|remove|list

Manage trusted repos. Once tapped, install by bare name.

augy tap add mattpocock/skills
augy tap add org/internal-skills          # private repos work too
augy tap add mattpocock/skills --path skills/engineering
augy tap list
augy tap remove mattpocock/skills

augy bundle

Generate an augy.json manifest from your currently installed skills. Commit this file so teammates can reproduce your exact skill set with augy sync.

augy bundle                       # writes ./augy.json
augy bundle --output ~/augy.json  # custom path
augy bundle --include-untracked   # include skills with no known source

augy.json format:

{
  "version": 1,
  "skills": {
    "tdd": "mattpocock/skills/skills/engineering/tdd",
    "commit": "anomalyco/agent-skills/skills/commit"
  }
}

augy sync [path]

Install and update skills from an augy.json manifest. Skills in your registry but not in the manifest are left alone — nothing is auto-removed.

augy sync                         # reads ./augy.json
augy sync ~/team/augy.json        # explicit path
augy sync --dry-run               # preview changes without applying
augy sync --agent opencode claude # target specific agents

augy set-source <skill> <url>

Attach a GitHub source to a skill imported without one. Accepts tree and blob URLs. Enables updates, diffs, and rollbacks.

augy set-source commit https://github.com/owner/repo/tree/main/skills/commit

augy uninstall <skill>

Remove a skill from all agent paths and the registry. Optionally prune version archives.

augy uninstall tdd

augy pin|unpin <skill>

Pin a skill to freeze it at the current version, skipping it during augy update.

augy pin tdd
augy unpin tdd

---

Taps

Taps are GitHub repos you trust as skill sources. The tap system is how augy stays decentralized — there is no central index, just repos you choose to register.

augy tap add mattpocock/skills        # public repo
augy tap add your-org/private-skills  # private repo — works the same way
augy install tdd                      # resolves via taps automatically

Any GitHub repo containing a SKILL.md file (or subdirectories that do) is a valid tap. The source of truth is GitHub. augy just tracks what you've installed and from where.

---

Version storage

Every upgrade archives the current skill files to ~/.augy/versions/<skill>/<sha>/ before overwriting. No external service required — snapshots live on your machine.

~/.augy/
  registry.json             ← lockfile — plain JSON, human-readable
  versions/
    tdd/
      7afa86d.../           ← snapshot before last upgrade
      abc1234.../           ← older snapshot

---

Environment variables

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

---

Docs

Full documentation at callmeradical.github.io/augy

---

License

MIT