@callmeradical/augy 0.4.0 → 0.6.0

package/dist/author-G46NJ3OW.js

@@ -0,0 +1,109 @@
+import {
+  AGENTS,
+  agentSkillPath,
+  detectInstalledAgents
+} from "./chunk-V5GA2ZHU.js";
+import {
+  createSkillRecord,
+  getSkill,
+  readRegistry,
+  upsertSkill,
+  writeRegistry
+} from "./chunk-JM4VVAHN.js";
+
+// src/commands/author.ts
+import { intro, outro, multiselect, isCancel } from "@clack/prompts";
+import chalk from "chalk";
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
+import { spawn } from "child_process";
+function skillTemplate(name) {
+  return `# Skill: ${name}
+
+## Overview
+
+<!-- Describe what this skill does and when to use it. -->
+
+## Workflow
+
+<!-- Step-by-step instructions for the agent. -->
+
+1. 
+
+## Notes
+
+<!-- Tips, caveats, or references. -->
+`;
+}
+async function authorNewCommand(name, opts = {}) {
+  intro(chalk.bold("augy") + chalk.dim(` \u2014 author new ${name}`));
+  const registry = await readRegistry();
+  if (getSkill(registry, name)) {
+    throw new Error(`Skill "${name}" already exists in the registry. Use \`augy author edit ${name}\` to open it.`);
+  }
+  const available = detectInstalledAgents();
+  if (!available.length) {
+    throw new Error("No agents detected. Install an agent first.");
+  }
+  const selected = available.length === 1 ? [available[0].id] : await multiselect({
+    message: "Install for which agents?",
+    options: available.map((a) => ({ value: a.id, label: a.name })),
+    initialValues: available.map((a) => a.id)
+  });
+  if (isCancel(selected)) {
+    console.log(chalk.dim("Cancelled."));
+    process.exit(0);
+  }
+  const targetAgents = AGENTS.filter((a) => selected.includes(a.id));
+  const agentPaths = {};
+  for (const agent of targetAgents) {
+    const dest = agentSkillPath(agent, name);
+    agentPaths[agent.id] = dest;
+    await mkdir(dest, { recursive: true });
+    await writeFile(join(dest, "SKILL.md"), skillTemplate(name), "utf8");
+  }
+  const record = createSkillRecord({
+    name,
+    source: "",
+    gigetSource: "",
+    sha: "unversioned",
+    agentIds: targetAgents.map((a) => a.id),
+    agentPaths
+  });
+  upsertSkill(registry, record);
+  await writeRegistry(registry);
+  const firstPath = agentPaths[targetAgents[0].id];
+  outro(
+    `${chalk.green("\u2713")} ${chalk.cyan(name)} created
+` + chalk.dim(`  ${firstPath}
+`) + chalk.dim("  Run `augy home push` when ready to back it up.")
+  );
+  if (!opts.noEdit) {
+    openInEditor(firstPath);
+  }
+}
+async function authorEditCommand(name) {
+  const registry = await readRegistry();
+  const skill = getSkill(registry, name);
+  if (!skill) {
+    throw new Error(`Skill "${name}" not found in registry. Run \`augy list\` to see installed skills.`);
+  }
+  const agentPath = Object.values(skill.agents).find((a) => a.active)?.path;
+  if (!agentPath) {
+    throw new Error(`No active agent path found for "${name}".`);
+  }
+  console.log(chalk.dim(`Opening ${agentPath}\u2026`));
+  openInEditor(agentPath);
+}
+function openInEditor(path) {
+  const editor = process.env["EDITOR"] ?? process.env["VISUAL"] ?? "vi";
+  const child = spawn(editor, [path], {
+    stdio: "inherit",
+    detached: true
+  });
+  child.unref();
+}
+export {
+  authorEditCommand,
+  authorNewCommand
+};

package/dist/{chunk-RBF4Q6N4.js → chunk-A3USXURD.js}

@@ -416,6 +416,7 @@ async function filterableMultiselect(opts) {
   const allOptions = opts.options.map((o) => ({ value: o.value, label: o.label, hint: o.hint }));
   const initialValues = opts.options.filter((o) => o.selected).map((o) => o.value);
   let filterText = "";
+  let filterMode = false;
   let matchCount = allOptions.length;
   const pageSize = opts.pageSize ?? Math.min(14, process2.stdout.rows - 6);
   const prompt = new wD({
@@ -438,11 +439,11 @@ ${headerPrefix}  ${opts.message}` + chalk.dim(`  (${allOptions.length} total)
 ${chalk.gray(S_BAR)}
 `;
       }
-      const cursor = filterText.length > 0 ? chalk.inverse(" ") : chalk.inverse(chalk.hidden("_"));
       const noMatch = matchCount === 0 && filterText.length > 0;
       const matchLabel = noMatch ? chalk.red("no matches") : filterText ? chalk.dim(`${matchCount} matched`) : chalk.dim(`${allOptions.length} skills`);
-      const hint = chalk.dim("space select \xB7 a all \xB7 enter confirm");
-      const filterLine = `${chalk.cyan(S_BAR)}  ` + chalk.dim("/ ") + (filterText ? chalk.white(filterText) : chalk.dim("type to filter")) + cursor + `  ${matchLabel}  ${hint}`;
+      const hint = filterMode ? chalk.dim("esc to clear \xB7 enter confirm") : chalk.dim("/ filter \xB7 a all \xB7 space select \xB7 enter confirm");
+      const filterDisplay = filterMode ? chalk.white(filterText) + chalk.inverse(" ") : filterText ? chalk.dim("/ ") + chalk.white(filterText) + chalk.dim(" (/ to edit)") : chalk.dim("/ to filter");
+      const filterLine = `${filterMode ? chalk.cyan(S_BAR) : chalk.gray(S_BAR)}  ` + filterDisplay + `  ${matchLabel}  ${hint}`;
       const visibleOptions = paginate(
         this.options,
         this.cursor,
@@ -471,19 +472,47 @@ ${chalk.cyan(S_BAR_END)}
     }
   });
   prompt.on("key", (key) => {
-    if (key === "\b" || key === "\x7F" || key === "backspace") {
-      filterText = filterText.slice(0, -1);
-    } else if (key && key.length === 1 && key.charCodeAt(0) >= 32) {
-      if (key === " ") return;
-      filterText += key;
-    } else {
+    const p = prompt;
+    if (filterMode) {
+      if (key === "\x1B") {
+        filterMode = false;
+        filterText = "";
+      } else if (key === "\b" || key === "\x7F" || key === "backspace") {
+        if (filterText.length > 0) {
+          filterText = filterText.slice(0, -1);
+        } else {
+          filterMode = false;
+        }
+      } else if (key === "/") {
+        filterMode = false;
+        return;
+      } else if (key && key.length === 1 && key.charCodeAt(0) >= 32 && key !== " ") {
+        filterText += key;
+      } else {
+        return;
+      }
+      const filtered = filterText ? allOptions.filter((o) => o.label.toLowerCase().includes(filterText.toLowerCase())) : allOptions;
+      matchCount = filtered.length;
+      p.options = filtered;
+      if (p.cursor >= filtered.length) p.cursor = Math.max(0, filtered.length - 1);
+      return;
+    }
+    if (key === "/") {
+      filterMode = true;
       return;
     }
-    const filtered = filterText ? allOptions.filter((o) => o.label.toLowerCase().includes(filterText.toLowerCase())) : allOptions;
-    matchCount = filtered.length;
-    prompt.options = filtered;
-    if (prompt.cursor >= filtered.length) {
-      prompt.cursor = Math.max(0, filtered.length - 1);
+    if (key === "a") {
+      const visibleValues = p.options.map((o) => o.value);
+      const currentSelected = Array.isArray(p.value) ? p.value : [];
+      const allVisible = visibleValues.every((v2) => currentSelected.includes(v2));
+      if (allVisible) {
+        p.value = currentSelected.filter((v2) => !visibleValues.includes(v2));
+      } else {
+        const union = [...currentSelected];
+        for (const v2 of visibleValues) if (!union.includes(v2)) union.push(v2);
+        p.value = union;
+      }
+      return;
     }
   });
   const result = await prompt.prompt();

package/dist/{home-TWK3PMCL.js → home-AEZ5IVC3.js}

@@ -1,3 +1,6 @@
+import {
+  filterableMultiselect
+} from "./chunk-A3USXURD.js";
 import {
   AGENTS,
   agentSkillPath,
@@ -14,7 +17,7 @@ import {
 } from "./chunk-JM4VVAHN.js";
 
 // src/commands/home.ts
-import { intro, outro, spinner } from "@clack/prompts";
+import { intro, isCancel, multiselect, outro, spinner } from "@clack/prompts";
 import chalk from "chalk";
 import { cp, mkdir, readdir, writeFile } from "fs/promises";
 import { existsSync } from "fs";
@@ -98,21 +101,20 @@ async function homePushCommand() {
   s.start(`Cloning ${chalk.cyan(home.repo)}\u2026`);
   await cloneRepo(repoToUrl(home.repo), cloneDir);
   s.stop(`${chalk.green("\u2713")} Cloned`);
-  const homeRepo = home.repo;
   for (const skill of authored) {
     const sourcePath = Object.values(skill.agents).find((a) => a.active && existsSync(a.path))?.path;
     if (!sourcePath) continue;
     const destPath = home.skillsPath ? join(cloneDir, home.skillsPath, skill.name) : join(cloneDir, skill.name);
     await mkdir(destPath, { recursive: true });
     await cp(sourcePath, destPath, { recursive: true, force: true });
-    const newSource = `https://github.com/${homeRepo}/tree/main/${home.skillsPath ? home.skillsPath + "/" : ""}${skill.name}`;
-    skill.source = newSource;
-    upsertSkill(registry, skill);
   }
   const bundle = { version: 1, skills: {} };
-  for (const skill of allSkills) {
+  for (const skill of external) {
     bundle.skills[skill.name] = skill.source;
   }
+  for (const skill of authored) {
+    bundle.skills[skill.name] = "";
+  }
   await writeFile(
     join(cloneDir, home.path),
     JSON.stringify(bundle, null, 2) + "\n",
@@ -125,8 +127,6 @@ async function homePushCommand() {
   const authoredNote = authored.length ? ` (${authored.length} authored)` : "";
   await gitCommit(cloneDir, `chore: update skills via augy \u2014 ${skillCount} skill(s)${authoredNote}`);
   await gitPush(cloneDir);
-  s2.stop(`${chalk.green("\u2713")} Pushed`);
-  if (authored.length) await writeRegistry(registry);
   outro(
     `${chalk.bold(String(skillCount))} skill(s) saved to ${chalk.cyan(home.repo)}
 ` + (authored.length ? chalk.dim(`  ${authored.length} authored skill(s) committed + source registered
@@ -138,9 +138,7 @@ async function homePullCommand(opts = {}) {
   const registry = await readRegistry();
   const home = getHomeConfig(registry);
   if (!home) {
-    console.error(
-      chalk.red("No home repo configured.") + "\nRun `augy home set <owner/repo>` first."
-    );
+    console.error(chalk.red("No home repo configured.") + "\nRun `augy home set <owner/repo>` first.");
     process.exit(1);
   }
   const cloneDir = join(tmpdir(), `augy-home-pull-${Date.now()}`);
@@ -148,53 +146,97 @@ async function homePullCommand(opts = {}) {
   s.start(`Cloning ${chalk.cyan(home.repo)}\u2026`);
   await cloneRepo(repoToUrl(home.repo), cloneDir);
   s.stop(`${chalk.green("\u2713")} Cloned`);
-  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 available = [];
   const skillsDir = home.skillsPath ? join(cloneDir, home.skillsPath) : cloneDir;
-  const authoredInstalled = [];
   if (existsSync(skillsDir)) {
     const entries = await readdir(skillsDir, { withFileTypes: true });
-    const skillDirs = entries.filter((e) => e.isDirectory());
-    for (const dir of skillDirs) {
-      const skillName = dir.name;
-      const srcPath = join(skillsDir, skillName);
-      const source = `https://github.com/${home.repo}/tree/main/${home.skillsPath ? home.skillsPath + "/" : ""}${skillName}`;
-      if (opts.dryRun) {
-        console.log(`  ${chalk.cyan("+")} ${skillName}  ${chalk.dim("(authored)")}`);
-        continue;
-      }
-      const agentPaths = {};
-      for (const agent of targetAgents) {
-        const dest = agentSkillPath(agent, skillName);
-        await mkdir(dest, { recursive: true });
-        await cp(srcPath, dest, { recursive: true, force: true });
-        agentPaths[agent.id] = dest;
-      }
-      const record = createSkillRecord({
-        name: skillName,
-        source,
-        gigetSource: "",
-        sha: "home",
-        agentIds: targetAgents.map((a) => a.id),
-        agentPaths
-      });
-      upsertSkill(registry, record);
-      authoredInstalled.push(skillName);
+    for (const e of entries) {
+      if (e.isDirectory()) available.push({ name: e.name, source: "", isAuthored: true });
     }
   }
   const manifestPath = join(cloneDir, home.path);
   if (existsSync(manifestPath)) {
-    const { syncCommand } = await import("./sync-QQFXUXCN.js");
-    await syncCommand(manifestPath, opts);
+    const { readFile } = await import("fs/promises");
+    const bundle = JSON.parse(await readFile(manifestPath, "utf8"));
+    for (const [name, source] of Object.entries(bundle.skills)) {
+      if (source && !available.find((s2) => s2.name === name)) {
+        available.push({ name, source, isAuthored: false });
+      }
+    }
+  }
+  if (!available.length) {
+    outro(chalk.dim("No skills found in home repo."));
+    return;
+  }
+  const selected = await filterableMultiselect({
+    message: `Select skills to install  ${chalk.dim(`(${available.length} available)`)}`,
+    options: available.map((sk) => ({
+      value: sk,
+      label: sk.name,
+      hint: sk.isAuthored ? chalk.dim("authored") : chalk.dim(sk.source),
+      selected: true
+    }))
+  });
+  if (isCancel(selected) || !selected.length) {
+    console.log(chalk.dim("Cancelled."));
+    process.exit(0);
+  }
+  const toInstall = selected;
+  let targetAgents = opts.agent?.length ? AGENTS.filter((a) => opts.agent.includes(a.id)) : detectInstalledAgents();
+  if (!opts.agent?.length) {
+    const agentResult = await multiselect({
+      message: "Install to which agents?",
+      options: targetAgents.map((a) => ({ value: a.id, label: a.name })),
+      initialValues: targetAgents.map((a) => a.id)
+    });
+    if (isCancel(agentResult)) {
+      console.log(chalk.dim("Cancelled."));
+      process.exit(0);
+    }
+    targetAgents = AGENTS.filter((a) => agentResult.includes(a.id));
   }
-  if (!opts.dryRun && authoredInstalled.length) {
-    await writeRegistry(registry);
+  if (!targetAgents.length) {
+    console.error(chalk.red("No agents selected."));
+    process.exit(1);
   }
   if (opts.dryRun) {
+    for (const sk of toInstall) {
+      console.log(`  ${chalk.cyan("+")} ${sk.name}  ${chalk.dim(sk.isAuthored ? "authored" : sk.source)}`);
+    }
     outro(chalk.dim("Dry run \u2014 no changes made."));
+    return;
+  }
+  const authoredToInstall = toInstall.filter((sk) => sk.isAuthored);
+  for (const sk of authoredToInstall) {
+    const srcPath = join(skillsDir, sk.name);
+    const agentPaths = {};
+    for (const agent of targetAgents) {
+      const dest = agentSkillPath(agent, sk.name);
+      await mkdir(dest, { recursive: true });
+      await cp(srcPath, dest, { recursive: true, force: true });
+      agentPaths[agent.id] = dest;
+    }
+    const record = createSkillRecord({
+      name: sk.name,
+      source: "",
+      gigetSource: "",
+      sha: "home",
+      agentIds: targetAgents.map((a) => a.id),
+      agentPaths
+    });
+    upsertSkill(registry, record);
+  }
+  if (authoredToInstall.length) await writeRegistry(registry);
+  const externalToInstall = toInstall.filter((sk) => !sk.isAuthored);
+  if (externalToInstall.length) {
+    const { tmpdir: td } = await import("os");
+    const { writeFile: wf } = await import("fs/promises");
+    const filteredBundle = { version: 1, skills: {} };
+    for (const sk of externalToInstall) filteredBundle.skills[sk.name] = sk.source;
+    const tmpManifest = join(td(), `augy-home-pull-manifest-${Date.now()}.json`);
+    await wf(tmpManifest, JSON.stringify(filteredBundle, null, 2) + "\n", "utf8");
+    const { syncCommand } = await import("./sync-QQFXUXCN.js");
+    await syncCommand(tmpManifest, { ...opts, agent: targetAgents.map((a) => a.id) });
   }
 }
 export {

package/dist/index.js

@@ -10,7 +10,7 @@ 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-7ZWHGCFN.js");
+  const { installCommand } = await import("./install-27YDQ46H.js");
   await installCommand(url, opts ?? {});
 });
 program.command("update [skill]").description("Check for upstream changes and upgrade installed skills").action(async (skill) => {
@@ -36,7 +36,7 @@ program.command("sync [path]").description("Install/update skills from an augy.j
   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-4KFMTKHO.js");
+  const { scanCommand } = await import("./scan-6HFU774V.js");
   await scanCommand();
 });
 program.command("info <skill>").description("Show full metadata, version history, and description for an installed skill").action(async (skill) => {
@@ -78,25 +78,34 @@ program.command("pin <skill>").description("Pin a skill so it is skipped during
 program.command("unpin <skill>").description("Allow a pinned skill to receive updates again").action(async (skill) => {
   await setPinned(skill, false);
 });
+var author = program.command("author").description("Create and edit self-authored skills");
+author.command("new <name>").description("Scaffold a new skill and open it in $EDITOR").option("--no-edit", "Skip opening the editor after creating").action(async (name, opts) => {
+  const { authorNewCommand } = await import("./author-G46NJ3OW.js");
+  await authorNewCommand(name, { noEdit: !opts.edit });
+});
+author.command("edit <name>").description("Open an existing skill in $EDITOR").action(async (name) => {
+  const { authorEditCommand } = await import("./author-G46NJ3OW.js");
+  await authorEditCommand(name);
+});
 var home = program.command("home").description("Manage a personal GitHub repo for backing up your skills manifest");
 home.command("set <repo>").description("Set the home repo  e.g. augy home set alice/my-skills").option("--path <file>", "Manifest path within the repo (default: augy.json)").option("--skills-path <dir>", "Dir for authored skills in the repo (default: skills)").action(async (repo, opts) => {
-  const { homeSetCommand } = await import("./home-TWK3PMCL.js");
+  const { homeSetCommand } = await import("./home-AEZ5IVC3.js");
   await homeSetCommand(repo, opts);
 });
 home.command("push").description("Push your installed skills manifest to the home repo").action(async () => {
-  const { homePushCommand } = await import("./home-TWK3PMCL.js");
+  const { homePushCommand } = await import("./home-AEZ5IVC3.js");
   await homePushCommand();
 });
 home.command("pull").description("Fetch the manifest from the home repo and sync skills").option("--dry-run", "Preview changes without applying them").option("-a, --agent <agents...>", "Target agent(s) (default: all detected)").action(async (opts) => {
-  const { homePullCommand } = await import("./home-TWK3PMCL.js");
+  const { homePullCommand } = await import("./home-AEZ5IVC3.js");
   await homePullCommand(opts);
 });
 home.command("show").description("Show the current home repo configuration").action(async () => {
-  const { homeShowCommand } = await import("./home-TWK3PMCL.js");
+  const { homeShowCommand } = await import("./home-AEZ5IVC3.js");
   await homeShowCommand();
 });
 program.action(async () => {
-  const { installCommand } = await import("./install-7ZWHGCFN.js");
+  const { installCommand } = await import("./install-27YDQ46H.js");
   await installCommand();
 });
 program.parse();

package/dist/{install-7ZWHGCFN.js → install-27YDQ46H.js}

@@ -1,6 +1,6 @@
 import {
   filterableMultiselect
-} from "./chunk-RBF4Q6N4.js";
+} from "./chunk-A3USXURD.js";
 import {
   resolveSkillFromTaps
 } from "./chunk-HZSFPII7.js";

package/dist/{scan-4KFMTKHO.js → scan-6HFU774V.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-KCQY4IDO.js";
 import {
   filterableMultiselect
-} from "./chunk-RBF4Q6N4.js";
+} from "./chunk-A3USXURD.js";
 import {
   resolveSkillFromTaps
 } from "./chunk-HZSFPII7.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callmeradical/augy",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Homebrew for AI agent skills — install, version, update, rollback",
   "type": "module",
   "license": "MIT",
@@ -25,6 +25,7 @@
   ],
   "files": [
     "dist/**/*",
+    "skills/**/*",
     "README.md",
     "LICENSE"
   ],

package/skills/author/SKILL.md

@@ -0,0 +1,81 @@
+# Skill: author
+
+A meta-skill for authoring new augy skills. Use this when the user wants
+to create a new skill for their AI agents.
+
+## What is an augy skill?
+
+A skill is a directory containing a `SKILL.md` file. That file is loaded
+by an AI agent as context — giving it specialised knowledge, workflows,
+or tool integrations for a specific task.
+
+Skills are installed per-agent:
+```
+~/.opencode/skills/<name>/SKILL.md
+~/.claude/skills/<name>/SKILL.md
+~/.codex/skills/<name>/SKILL.md
+```
+
+## Workflow
+
+### 1. Scaffold the skill
+
+```sh
+augy author new <name>
+```
+
+This creates the skill directory for your installed agents, registers it
+in the augy registry, and opens it in `$EDITOR`.
+
+### 2. Write the SKILL.md
+
+A good SKILL.md has:
+
+- **One-line description** — what this skill does and when to invoke it
+- **Trigger phrases** — phrases the user says that should activate this skill
+- **Workflow** — numbered steps the agent follows
+- **Examples** — concrete inputs and expected outputs
+- **References** — links to docs, files, or other skills
+
+Keep it focused. One skill = one capability. If it grows beyond ~150 lines,
+consider splitting it.
+
+### 3. Test it
+
+Load the skill into your agent and try the trigger phrases. Check that the
+agent follows the workflow correctly.
+
+### 4. Back it up
+
+```sh
+augy home push
+```
+
+This commits the skill to your home repo so it's available on all your machines.
+
+## SKILL.md template
+
+```markdown
+# Skill: <name>
+
+<One-sentence description of what this skill does.>
+Trigger on: <phrase 1>, <phrase 2>, <phrase 3>.
+
+## Workflow
+
+1. <First step>
+2. <Second step>
+3. <Third step>
+
+## Notes
+
+<!-- Tips, caveats, edge cases -->
+```
+
+## Tips
+
+- **Verb-first steps**: "Run the tests", not "Tests should be run"
+- **Concrete over abstract**: Show exact commands, not just concepts
+- **Fail states**: Tell the agent what to do when things go wrong
+- **Scope**: If you find yourself writing "unless X, in which case Y", that's
+  a second skill