@callmeradical/augy 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,10 @@
 # augy
 
-**Homebrew for AI agent skills** — install, version, update, and rollback skills across OpenCode, Claude, and Codex from a single CLI.
+[![npm](https://img.shields.io/npm/v/@callmeradical/augy?label=%40callmeradical%2Faugy&color=7c3aed)](https://www.npmjs.com/package/@callmeradical/augy)
+[![license](https://img.shields.io/github/license/callmeradical/augy)](LICENSE)
+[![node](https://img.shields.io/node/v/@callmeradical/augy)](package.json)
+
+**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
@@ -11,53 +15,87 @@ 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
 
 ```bash
-npm install -g augy
+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 (GitHub), and what version (commit SHA) is on disk — then lets you update, diff, and roll back just like a package manager.
+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**
 
-| Agent | Default skills path |
-|---|---|
-| OpenCode | `~/.opencode/skills/` |
-| Claude | `~/.claude/skills/` |
-| Codex | `~/.codex/skills/` (or `$CODEX_HOME/skills`) |
+augy auto-detects which agents are installed on your machine and pre-selects them in the install prompt. All 33 are supported:
 
-A single skill can be deployed to multiple agents simultaneously.
+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
+
+```bash
+# 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 registered tap.
+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.
 
 ```bash
+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 mattpocock/skills/skills/engineering/tdd
-augy install tdd                    # resolves via taps
-augy install tdd --agent opencode   # target a specific agent
+augy install tdd --agent opencode claude                  # specific agents
 ```
 
 ### `augy scan`
-Find skills already on disk that augy doesn't know about. Auto-detects provenance via git remotes and `SKILL.md` frontmatter, groups results into *detected* vs *no provenance found* with filesystem paths shown for unknown skills. Imports them into the registry.
+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.
 
 ```bash
 augy scan
 ```
 
 ### `augy update [skill]`
-Check all installed skills for upstream SHA drift. Shows a list of available upgrades, lets you select which to apply, archives the current version before overwriting.
+Check all installed skills for upstream SHA drift. Archives the current version, then deploys the new one.
 
 ```bash
 augy update              # check + upgrade everything
@@ -70,19 +108,19 @@ Interactive file-level diff browser. Three modes:
 ```bash
 augy diff tdd                    # installed ↔ upstream HEAD
 augy diff tdd abc1234            # installed ↔ specific SHA
-augy diff tdd abc1234 def5678    # two local archives
+augy diff tdd abc1234 def5678    # two local archives side-by-side
 ```
 
 ### `augy rollback <skill> [sha]`
-Restore a skill to any previously archived version.
+Restore a skill to any previously archived version. Without a SHA, shows an interactive picker.
 
 ```bash
-augy rollback tdd                # interactive version picker
-augy rollback tdd abc1234        # specific SHA (short or full)
+augy rollback tdd
+augy rollback tdd abc1234
 ```
 
 ### `augy list`
-Show all installed skills, their SHAs, agents, and update status.
+Show all installed skills, their SHAs, agents, and version history.
 
 ```bash
 augy list
@@ -90,32 +128,63 @@ augy list --json    # raw registry JSON
 ```
 
 ### `augy info <skill>`
-Full metadata: source, SHA, agents with paths, version history, and a preview of the skill description.
+Full metadata: source, SHA, agents with paths, version history, and a description preview from `SKILL.md`.
 
 ```bash
 augy info tdd
 ```
 
 ### `augy search [query]`
-Search all registered taps for available skills.
+Search all registered taps for available skills. Shows install status and whether each skill is up to date.
 
 ```bash
-augy search           # full index
+augy search           # full index across all taps
 augy search tdd       # filter by name
 ```
 
 ### `augy tap add|remove|list`
-Manage trusted repos (taps) — once added, skills can be installed by bare name.
+Manage trusted repos. Once tapped, install by bare name.
 
 ```bash
 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`.
+
+```bash
+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:
+```json
+{
+  "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.
+
+```bash
+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 (e.g. via `augy scan`). Enables updates and diffs. Accepts tree and blob URLs.
+Attach a GitHub source to a skill imported without one. Accepts tree and blob URLs. Enables updates, diffs, and rollbacks.
 
 ```bash
 augy set-source commit https://github.com/owner/repo/tree/main/skills/commit
@@ -129,7 +198,7 @@ augy uninstall tdd
 ```
 
 ### `augy pin|unpin <skill>`
-Pin a skill to skip it during `augy update`.
+Pin a skill to freeze it at the current version, skipping it during `augy update`.
 
 ```bash
 augy pin tdd
@@ -140,22 +209,25 @@ augy unpin tdd
 
 ## Taps
 
-Taps are trusted GitHub repos containing skills. Add one and install by name without knowing the full URL:
+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.
 
 ```bash
-augy tap add mattpocock/skills
-augy install tdd        # resolves to mattpocock/skills automatically
+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 to `~/.augy/versions/<skill>/<sha>/` before overwriting it — giving you a full local snapshot history to diff or rollback to at any time.
+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 (human-readable JSON)
+  registry.json             ← lockfile — plain JSON, human-readable
   versions/
     tdd/
       7afa86d.../           ← snapshot before last upgrade
@@ -170,13 +242,13 @@ Every upgrade archives the current skill to `~/.augy/versions/<skill>/<sha>/` be
 |---|---|---|
 | `AUGY_HOME` | `~/.augy` | Override augy's home directory |
 | `CODEX_HOME` | `~/.codex` | Override Codex agent path |
-| `GITHUB_TOKEN` | — | Raise GitHub API rate limit from 60 to 5000 req/hr |
+| `GITHUB_TOKEN` | — | Raise GitHub API rate limit from 60 → 5,000 req/hr |
 
 ---
 
 ## Docs
 
-Full documentation at **[augy.dev](https://augy.dev)** *(coming soon — see `docs/` for the source)*.
+Full documentation at **[callmeradical.github.io/augy](https://callmeradical.github.io/augy)**
 
 ---
 

package/dist/bundle-76RCX45C.js

@@ -0,0 +1,49 @@
+import {
+  listSkills,
+  readRegistry
+} from "./chunk-ZW6ZKHTF.js";
+
+// src/commands/bundle.ts
+import { outro, spinner } from "@clack/prompts";
+import chalk from "chalk";
+import { writeFile } from "fs/promises";
+import { join } from "path";
+import { cwd } from "process";
+var DEFAULT_FILENAME = "augy.json";
+async function bundleCommand(opts) {
+  const registry = await readRegistry();
+  const skills = listSkills(registry);
+  if (!skills.length) {
+    console.log(chalk.dim("No skills installed. Nothing to bundle."));
+    return;
+  }
+  const tracked = skills.filter((s2) => s2.source);
+  const untracked = skills.filter((s2) => !s2.source);
+  const bundle = {
+    version: 1,
+    skills: {}
+  };
+  for (const skill of tracked) {
+    bundle.skills[skill.name] = skill.source;
+  }
+  if (opts.includeUntracked) {
+    for (const skill of untracked) {
+      bundle.skills[skill.name] = "";
+    }
+  }
+  const outputPath = opts.output ?? join(cwd(), DEFAULT_FILENAME);
+  const s = spinner();
+  s.start(`Writing ${chalk.cyan(outputPath)}\u2026`);
+  await writeFile(outputPath, JSON.stringify(bundle, null, 2) + "\n", "utf8");
+  s.stop(`${chalk.green("\u2713")} Bundle written  ${chalk.dim(outputPath)}`);
+  const skillCount = Object.keys(bundle.skills).length;
+  const skippedNote = !opts.includeUntracked && untracked.length > 0 ? chalk.dim(`
+  ${untracked.length} untracked skill(s) omitted \u2014 use --include-untracked to add them`) : "";
+  outro(
+    `${chalk.bold(String(skillCount))} skill(s) bundled${skippedNote}
+` + chalk.dim("  Commit augy.json to share this skill set with your team.\n") + chalk.dim("  Teammates run `augy sync` to install from it.")
+  );
+}
+export {
+  bundleCommand
+};

package/dist/chunk-V5GA2ZHU.js

@@ -0,0 +1,65 @@
+// src/agents.ts
+import { homedir } from "os";
+import { join } from "path";
+import { existsSync } from "fs";
+function h(p) {
+  return p.startsWith("~") ? join(homedir(), p.slice(1)) : p;
+}
+function codexSkillsPath() {
+  const codexHome = process.env["CODEX_HOME"];
+  return codexHome ? join(codexHome, "skills") : h("~/.codex/skills");
+}
+var AGENTS = [
+  // ── Tier 1: most widely used ────────────────────────────────────
+  { id: "opencode", name: "OpenCode", skillsPath: h("~/.opencode/skills"), skillFile: "SKILL.md" },
+  { id: "claude", name: "Claude", skillsPath: h("~/.claude/skills"), skillFile: "SKILL.md" },
+  { id: "codex", name: "Codex", skillsPath: codexSkillsPath(), skillFile: "SKILL.md" },
+  { id: "cursor", name: "Cursor", skillsPath: h("~/.cursor/skills"), skillFile: "SKILL.md" },
+  { id: "windsurf", name: "Windsurf", skillsPath: h("~/.codeium/windsurf/skills"), skillFile: "SKILL.md" },
+  { id: "copilot", name: "GitHub Copilot", skillsPath: h("~/.github/skills"), skillFile: "SKILL.md" },
+  { id: "gemini", name: "Gemini CLI", skillsPath: h("~/.gemini/skills"), skillFile: "SKILL.md" },
+  { id: "goose", name: "Goose", skillsPath: h("~/.goose/skills"), skillFile: "SKILL.md" },
+  { id: "amp", name: "Amp", skillsPath: h("~/.agents/skills"), skillFile: "SKILL.md" },
+  { id: "roo", name: "Roo Code", skillsPath: h("~/.roo/skills"), skillFile: "SKILL.md" },
+  { id: "cline", name: "Cline", skillsPath: h("~/.cline/skills"), skillFile: "SKILL.md" },
+  // ── Tier 2: growing ─────────────────────────────────────────────
+  { id: "kiro", name: "Kiro", skillsPath: h("~/.kiro/skills"), skillFile: "SKILL.md" },
+  { id: "kimi", name: "Kimi CLI", skillsPath: h("~/.kimi/skills"), skillFile: "SKILL.md" },
+  { id: "kilocode", name: "Kilo Code", skillsPath: h("~/.kilocode/skills"), skillFile: "SKILL.md" },
+  { id: "trae", name: "Trae", skillsPath: h("~/.trae/skills"), skillFile: "SKILL.md" },
+  { id: "trae-cn", name: "Trae CN", skillsPath: h("~/.trae-cn/skills"), skillFile: "SKILL.md" },
+  { id: "augment", name: "Augment", skillsPath: h("~/.augment/rules"), skillFile: "SKILL.md" },
+  { id: "openhands", name: "OpenHands", skillsPath: h("~/.openhands/skills"), skillFile: "SKILL.md" },
+  { id: "replit", name: "Replit", skillsPath: h("~/.replit/skills"), skillFile: "SKILL.md" },
+  { id: "crush", name: "Crush", skillsPath: h("~/.config/crush/skills"), skillFile: "SKILL.md" },
+  // ── Tier 3: long tail ───────────────────────────────────────────
+  { id: "antigravity", name: "Antigravity", skillsPath: h("~/.gemini/antigravity/skills"), skillFile: "SKILL.md" },
+  { id: "droid", name: "Droid", skillsPath: h("~/.factory/skills"), skillFile: "SKILL.md" },
+  { id: "openclaw", name: "OpenClaw", skillsPath: h("~/.openclaw/skills"), skillFile: "SKILL.md" },
+  { id: "codebuddy", name: "CodeBuddy", skillsPath: h("~/.codebuddy/skills"), skillFile: "SKILL.md" },
+  { id: "commandcode", name: "Command Code", skillsPath: h("~/.commandcode/skills"), skillFile: "SKILL.md" },
+  { id: "kode", name: "Kode", skillsPath: h("~/.kode/skills"), skillFile: "SKILL.md" },
+  { id: "mistralvibe", name: "Mistral Vibe", skillsPath: h("~/.vibe/skills"), skillFile: "SKILL.md" },
+  { id: "mux", name: "Mux", skillsPath: h("~/.mux/skills"), skillFile: "SKILL.md" },
+  { id: "openclaude", name: "OpenClaude IDE", skillsPath: h("~/.openclaude/skills"), skillFile: "SKILL.md" },
+  { id: "qoder", name: "Qoder", skillsPath: h("~/.qoder/skills"), skillFile: "SKILL.md" },
+  { id: "qwen", name: "Qwen Code", skillsPath: h("~/.qwen/skills"), skillFile: "SKILL.md" },
+  { id: "neovate", name: "Neovate", skillsPath: h("~/.neovate/skills"), skillFile: "SKILL.md" },
+  { id: "adal", name: "AdaL", skillsPath: h("~/.adal/skills"), skillFile: "SKILL.md" }
+];
+function agentById(id) {
+  return AGENTS.find((a) => a.id === id);
+}
+function agentSkillPath(agent, skillName) {
+  return join(agent.skillsPath, skillName);
+}
+function detectInstalledAgents() {
+  return AGENTS.filter((a) => existsSync(a.skillsPath));
+}
+
+export {
+  AGENTS,
+  agentById,
+  agentSkillPath,
+  detectInstalledAgents
+};

package/dist/index.js

@@ -10,29 +10,37 @@ var pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8")
 var program = new Command();
 program.name("augy").description("Homebrew for AI agent skills \u2014 install, version, update, rollback").version(pkg.version);
 program.command("install [url]").description("Install skills from a GitHub URL or owner/repo[/path]").option("-a, --agent <agents...>", "Target agent(s): opencode, claude, codex").action(async (url, opts) => {
-  const { installCommand } = await import("./install-FPAGHWX2.js");
+  const { installCommand } = await import("./install-WXJUM6CM.js");
   await installCommand(url, opts ?? {});
 });
 program.command("update [skill]").description("Check for upstream changes and upgrade installed skills").action(async (skill) => {
-  const { updateCommand } = await import("./update-A3PSROUK.js");
+  const { updateCommand } = await import("./update-NIBPLLHU.js");
   await updateCommand(skill);
 });
 program.command("list").description("Show all installed skills with version + agent info").option("--json", "Output raw JSON registry").action(async (opts) => {
-  const { listCommand } = await import("./list-UJX2MYXK.js");
+  const { listCommand } = await import("./list-ZTG6RVGD.js");
   await listCommand(opts ?? {});
 });
 program.command("diff <skill> [sha1] [sha2]").description(
   "Browse file-level diffs for a skill\n  augy diff <skill>              installed \u2194 upstream HEAD\n  augy diff <skill> <sha>        installed \u2194 specific SHA (archive or GitHub)\n  augy diff <skill> <sha1> <sha2> two local archives side-by-side"
 ).action(async (skill, sha1, sha2) => {
-  const { diffCommand } = await import("./diff-KYSWUXMH.js");
+  const { diffCommand } = await import("./diff-VQU63ORX.js");
   await diffCommand(skill, sha1, sha2);
 });
+program.command("bundle").description("Write an augy.json manifest from installed skills for team sharing").option("-o, --output <path>", "Output path (default: ./augy.json)").option("--include-untracked", "Include skills without a known source").action(async (opts) => {
+  const { bundleCommand } = await import("./bundle-76RCX45C.js");
+  await bundleCommand(opts);
+});
+program.command("sync [path]").description("Install/update skills from an augy.json manifest (default: ./augy.json)").option("--dry-run", "Preview changes without applying them").option("-a, --agent <agents...>", "Target agent(s) (default: all detected)").action(async (path, opts) => {
+  const { syncCommand } = await import("./sync-VPBC2PBH.js");
+  await syncCommand(path, opts ?? {});
+});
 program.command("scan").description("Find skills installed outside augy and optionally import them into the registry").action(async () => {
-  const { scanCommand } = await import("./scan-DKN7YBT5.js");
+  const { scanCommand } = await import("./scan-MWUT7G4V.js");
   await scanCommand();
 });
 program.command("info <skill>").description("Show full metadata, version history, and description for an installed skill").action(async (skill) => {
-  const { infoCommand } = await import("./info-7BO4LXXS.js");
+  const { infoCommand } = await import("./info-JKGYNOPV.js");
   await infoCommand(skill);
 });
 program.command("search [query]").description("Search all taps for available skills (optionally filter by name)").action(async (query) => {
@@ -61,7 +69,7 @@ program.command("uninstall <skill>").description("Remove a skill from all agent
   await uninstallCommand(skill);
 });
 program.command("rollback <skill> [sha]").description("Restore a skill to a previous archived version").action(async (skill, sha) => {
-  const { rollbackCommand } = await import("./rollback-WAZV5HNG.js");
+  const { rollbackCommand } = await import("./rollback-QXPWOF3Q.js");
   await rollbackCommand(skill, sha);
 });
 program.command("pin <skill>").description("Pin a skill so it is skipped during `augy update`").action(async (skill) => {
@@ -71,7 +79,7 @@ program.command("unpin <skill>").description("Allow a pinned skill to receive up
   await setPinned(skill, false);
 });
 program.action(async () => {
-  const { installCommand } = await import("./install-FPAGHWX2.js");
+  const { installCommand } = await import("./install-WXJUM6CM.js");
   await installCommand();
 });
 program.parse();

package/dist/{info-7BO4LXXS.js → info-JKGYNOPV.js}

@@ -1,9 +1,9 @@
+import {
+  AGENTS
+} from "./chunk-V5GA2ZHU.js";
 import {
   archiveExists
 } from "./chunk-PX2LVUHV.js";
-import {
-  AGENTS
-} from "./chunk-R2TJ3UDO.js";
 import {
   getSkill,
   readRegistry,

package/dist/{install-FPAGHWX2.js → install-WXJUM6CM.js}

@@ -6,8 +6,9 @@ import {
 } from "./chunk-YXCEZ3EY.js";
 import {
   AGENTS,
-  agentSkillPath
-} from "./chunk-R2TJ3UDO.js";
+  agentSkillPath,
+  detectInstalledAgents
+} from "./chunk-V5GA2ZHU.js";
 import {
   discoverSkills,
   downloadSkill,
@@ -27,7 +28,6 @@ import {
   confirm,
   intro,
   isCancel,
-  multiselect,
   outro,
   select,
   spinner,
@@ -173,14 +173,15 @@ async function promptSkillSelection(skills) {
   });
 }
 async function promptAgentSelection() {
-  return multiselect({
+  const detected = new Set(detectInstalledAgents().map((a) => a.id));
+  return filterableMultiselect({
     message: "Install for which agents?",
     options: AGENTS.map((a) => ({
       value: a,
       label: a.name,
-      hint: chalk.dim(a.skillsPath)
-    })),
-    required: true
+      hint: detected.has(a.id) ? chalk.dim(a.skillsPath) : chalk.dim("not detected"),
+      selected: detected.has(a.id)
+    }))
   });
 }
 function bail() {

package/dist/{list-UJX2MYXK.js → list-ZTG6RVGD.js}

@@ -1,6 +1,6 @@
 import {
   AGENTS
-} from "./chunk-R2TJ3UDO.js";
+} from "./chunk-V5GA2ZHU.js";
 import {
   listSkills,
   readRegistry

package/dist/{rollback-WAZV5HNG.js → rollback-QXPWOF3Q.js}

@@ -1,11 +1,11 @@
+import {
+  agentById,
+  agentSkillPath
+} from "./chunk-V5GA2ZHU.js";
 import {
   archiveExists,
   restoreVersion
 } from "./chunk-PX2LVUHV.js";
-import {
-  agentById,
-  agentSkillPath
-} from "./chunk-R2TJ3UDO.js";
 import {
   getSkill,
   readRegistry,

package/dist/{scan-DKN7YBT5.js → scan-MWUT7G4V.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-YXCEZ3EY.js";
 import {
   AGENTS
-} from "./chunk-R2TJ3UDO.js";
+} from "./chunk-V5GA2ZHU.js";
 import {
   discoverSkills,
   parseGitHubUrl

package/dist/sync-VPBC2PBH.js

@@ -0,0 +1,189 @@
+import {
+  AGENTS,
+  agentSkillPath,
+  detectInstalledAgents
+} from "./chunk-V5GA2ZHU.js";
+import {
+  discoverSkills,
+  downloadSkill,
+  latestShaForPath,
+  parseGitHubUrl
+} from "./chunk-EU54UQ4C.js";
+import {
+  createSkillRecord,
+  getSkill,
+  readRegistry,
+  shortSha,
+  writeRegistry
+} from "./chunk-ZW6ZKHTF.js";
+
+// src/commands/sync.ts
+import {
+  confirm,
+  intro,
+  isCancel,
+  outro,
+  spinner
+} from "@clack/prompts";
+import chalk from "chalk";
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import { join } from "path";
+import { cwd } from "process";
+import { mkdir, rm } from "fs/promises";
+var DEFAULT_FILENAME = "augy.json";
+async function syncCommand(pathArg, opts = {}) {
+  intro(chalk.bold("augy") + chalk.dim(" \u2014 sync"));
+  const manifestPath = pathArg ?? join(cwd(), DEFAULT_FILENAME);
+  if (!existsSync(manifestPath)) {
+    console.error(
+      chalk.red(`No manifest found at ${manifestPath}
+`) + chalk.dim("Run `augy bundle` to create one.")
+    );
+    process.exit(1);
+  }
+  let bundle;
+  try {
+    bundle = JSON.parse(await readFile(manifestPath, "utf8"));
+  } catch {
+    console.error(chalk.red(`Could not parse ${manifestPath}`));
+    process.exit(1);
+  }
+  const entries = Object.entries(bundle.skills);
+  if (!entries.length) {
+    outro(chalk.dim("Manifest is empty \u2014 nothing to sync."));
+    return;
+  }
+  console.log(
+    chalk.dim(`
+  Manifest: ${manifestPath}`) + chalk.dim(`  (${entries.length} skill(s))
+`)
+  );
+  const targetAgents = opts.agent?.length ? AGENTS.filter((a) => opts.agent.includes(a.id)) : detectInstalledAgents();
+  if (!targetAgents.length) {
+    console.error(chalk.red("No agents detected. Install an agent or use --agent to specify one."));
+    process.exit(1);
+  }
+  const registry = await readRegistry();
+  const s = spinner();
+  s.start("Resolving skills\u2026");
+  const plan = [];
+  await Promise.allSettled(
+    entries.map(async ([name, source]) => {
+      if (!source) {
+        plan.push({ name, source: "", action: "no-source" });
+        return;
+      }
+      const installed = getSkill(registry, name);
+      try {
+        const coords = parseGitHubUrl(source);
+        const remoteSha = await latestShaForPath(
+          coords.owner,
+          coords.repo,
+          coords.path || ".",
+          coords.ref
+        );
+        if (!installed) {
+          plan.push({ name, source, action: "install", remoteSha });
+        } else if (installed.sha !== remoteSha) {
+          plan.push({ name, source, action: "upgrade", remoteSha });
+        } else {
+          plan.push({ name, source, action: "up-to-date", remoteSha });
+        }
+      } catch {
+        plan.push({ name, source, action: "no-source" });
+      }
+    })
+  );
+  const order = { install: 0, upgrade: 1, "up-to-date": 2, "no-source": 3 };
+  plan.sort((a, b) => order[a.action] - order[b.action]);
+  s.stop("Resolved");
+  const toInstall = plan.filter((p) => p.action === "install");
+  const toUpgrade = plan.filter((p) => p.action === "upgrade");
+  const upToDate = plan.filter((p) => p.action === "up-to-date");
+  const noSource = plan.filter((p) => p.action === "no-source");
+  if (toInstall.length) {
+    console.log(chalk.bold(`  Install (${toInstall.length})`));
+    for (const p of toInstall) {
+      console.log(`    ${chalk.cyan(p.name)}  ${chalk.dim(p.remoteSha ? "@" + shortSha(p.remoteSha) : "")}`);
+    }
+    console.log();
+  }
+  if (toUpgrade.length) {
+    console.log(chalk.bold(`  Upgrade (${toUpgrade.length})`));
+    for (const p of toUpgrade) {
+      const installed = getSkill(registry, p.name);
+      console.log(
+        `    ${chalk.cyan(p.name)}  ${chalk.dim(installed.shortSha)} \u2192 ${chalk.green(shortSha(p.remoteSha))}`
+      );
+    }
+    console.log();
+  }
+  if (upToDate.length) {
+    console.log(chalk.dim(`  Up to date (${upToDate.length}): `) + chalk.dim(upToDate.map((p) => p.name).join(", ")));
+    console.log();
+  }
+  if (noSource.length) {
+    console.log(chalk.yellow(`  Skipped \u2014 no source (${noSource.length}): `) + chalk.dim(noSource.map((p) => p.name).join(", ")));
+    console.log();
+  }
+  if (!toInstall.length && !toUpgrade.length) {
+    outro(chalk.green("Everything is up to date."));
+    return;
+  }
+  if (opts.dryRun) {
+    outro(chalk.dim("Dry run \u2014 no changes made."));
+    return;
+  }
+  const actionCount = toInstall.length + toUpgrade.length;
+  const ok = await confirm({
+    message: `Apply ${actionCount} change(s) to ${targetAgents.map((a) => a.name).join(", ")}?`
+  });
+  if (isCancel(ok) || !ok) {
+    console.log(chalk.dim("Cancelled."));
+    process.exit(0);
+  }
+  for (const entry of [...toInstall, ...toUpgrade]) {
+    const s2 = spinner();
+    s2.start(`${entry.action === "install" ? "Installing" : "Upgrading"} ${chalk.cyan(entry.name)}\u2026`);
+    try {
+      const coords = parseGitHubUrl(entry.source);
+      const remote = await discoverSkills(coords);
+      const match = remote.find((r) => r.name === entry.name) ?? remote[0];
+      if (!match) throw new Error("Skill not found at source");
+      const agentPaths = {};
+      for (const agent of targetAgents) {
+        const dest = agentSkillPath(agent, entry.name);
+        agentPaths[agent.id] = dest;
+        await rm(dest, { recursive: true, force: true });
+        await mkdir(dest, { recursive: true });
+        await downloadSkill(match.gigetSource, dest);
+      }
+      const existing = getSkill(registry, entry.name);
+      const record = createSkillRecord({
+        name: entry.name,
+        source: entry.source,
+        gigetSource: match.gigetSource,
+        sha: match.sha,
+        agentIds: targetAgents.map((a) => a.id),
+        agentPaths
+      });
+      if (existing) {
+        record.installedAt = existing.installedAt;
+        record.pinned = existing.pinned;
+        record.history = existing.history;
+      }
+      registry.skills[entry.name] = record;
+      await writeRegistry(registry);
+      s2.stop(
+        `${chalk.green("\u2713")} ${chalk.cyan(entry.name)}  ${chalk.dim("@" + shortSha(match.sha))}`
+      );
+    } catch (err) {
+      s2.stop(`${chalk.red("\u2717")} ${chalk.cyan(entry.name)} \u2014 ${String(err)}`);
+    }
+  }
+  outro(chalk.green(`Sync complete  ${chalk.dim(`(${actionCount} change(s) applied)`)}`));
+}
+export {
+  syncCommand
+};

package/dist/{update-A3PSROUK.js → update-NIBPLLHU.js}

@@ -1,15 +1,15 @@
-import {
-  archiveVersion
-} from "./chunk-PX2LVUHV.js";
 import {
   agentById,
   agentSkillPath
-} from "./chunk-R2TJ3UDO.js";
+} from "./chunk-V5GA2ZHU.js";
 import {
   discoverSkills,
   downloadSkill,
   parseGitHubUrl
 } from "./chunk-EU54UQ4C.js";
+import {
+  archiveVersion
+} from "./chunk-PX2LVUHV.js";
 import {
   listSkills,
   readRegistry,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callmeradical/augy",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Homebrew for AI agent skills — install, version, update, rollback",
   "type": "module",
   "license": "MIT",
@@ -35,7 +35,7 @@
     "build": "tsup src/index.ts --format esm --outDir dist --clean",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run typecheck && npm run build"
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "@clack/prompts": "^0.9.0",

package/dist/chunk-R2TJ3UDO.js

@@ -1,43 +0,0 @@
-// src/agents.ts
-import { homedir } from "os";
-import { join } from "path";
-function resolveHome(p) {
-  return p.startsWith("~") ? join(homedir(), p.slice(1)) : p;
-}
-function codexSkillsPath() {
-  const codexHome = process.env["CODEX_HOME"];
-  if (codexHome) return join(codexHome, "skills");
-  return resolveHome("~/.codex/skills");
-}
-var AGENTS = [
-  {
-    id: "opencode",
-    name: "OpenCode",
-    skillsPath: resolveHome("~/.opencode/skills"),
-    skillFile: "SKILL.md"
-  },
-  {
-    id: "claude",
-    name: "Claude",
-    skillsPath: resolveHome("~/.claude/skills"),
-    skillFile: "SKILL.md"
-  },
-  {
-    id: "codex",
-    name: "Codex",
-    skillsPath: codexSkillsPath(),
-    skillFile: "SKILL.md"
-  }
-];
-function agentById(id) {
-  return AGENTS.find((a) => a.id === id);
-}
-function agentSkillPath(agent, skillName) {
-  return join(agent.skillsPath, skillName);
-}
-
-export {
-  AGENTS,
-  agentById,
-  agentSkillPath
-};

package/dist/{diff-KYSWUXMH.js → diff-VQU63ORX.js}

@@ -1,10 +1,10 @@
-import {
-  archiveExists
-} from "./chunk-PX2LVUHV.js";
 import {
   discoverSkills,
   parseGitHubUrl
 } from "./chunk-EU54UQ4C.js";
+import {
+  archiveExists
+} from "./chunk-PX2LVUHV.js";
 import {
   getSkill,
   readRegistry,