codiedev 0.9.86 → 0.9.87

package/dist/codie.js

@@ -50,6 +50,7 @@ const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 const url_1 = require("url");
 const configDir_1 = require("./configDir");
+const utils_1 = require("./utils");
 const codieLauncher_1 = require("./codieLauncher");
 const codieBrandInstall_1 = require("./codieBrandInstall");
 const codieUsage_1 = require("./codieUsage");
@@ -274,12 +275,23 @@ async function main() {
     const capturePlugin = (0, codieLauncher_1.resolveCapturePlugin)({ homeDir: os.homedir(), existsSync: fs.existsSync });
     (0, codieBrandInstall_1.installTuiPlugin)();
     installBrandWordmark(runtime);
-    const config = (0, codieLauncher_1.buildCodieConfig)({
+    // OpenCode doesn't read the instruction blocks `connect` writes for other
+    // tools, so Codie ships its own copy of the Codiedev commands.
+    const instructionsFile = path.join(stateDir, "codie-instructions.md");
+    try {
+        fs.mkdirSync(stateDir, { recursive: true });
+        fs.writeFileSync(instructionsFile, (0, utils_1.codiedevInstructionsText)(), "utf8");
+    }
+    catch (error) {
+        console.error(`codie: couldn't write the Codiedev instructions (${error instanceof Error ? error.message : error})`);
+    }
+    const baseConfig = (0, codieLauncher_1.buildCodieConfig)({
         existing: withStarterPacks(existingInlineConfig(), new Set(catalog.map((model) => (0, codieLauncher_1.bareModel)(model.id)).filter(Boolean)), catalog),
         catalog,
         env: { ...process.env, ...parsed.overrides, CODIEDEV_GATEWAY_URL: gatewayUrl },
         plugins: [capturePlugin, metadataPlugin],
     });
+    const config = fs.existsSync(instructionsFile) ? (0, codieLauncher_1.withCodiedevInstructions)(baseConfig, instructionsFile) : baseConfig;
     const env = {
         ...process.env,
         ...parsed.overrides,

package/dist/codieLauncher.d.ts

@@ -33,6 +33,10 @@ export declare function usableModelLimit(value: unknown): ModelLimit | undefined
  */
 export declare function withCodieWorkingDirectory(args: string[], cwd: string): string[];
 export declare function bareModel(value: unknown): string;
+/** Add the Codiedev instructions file to OpenCode's `instructions` (kept
+ * alongside the user's own, never duplicated). Codie writes the file itself:
+ * OpenCode never sees the instruction blocks `connect` writes for other tools. */
+export declare function withCodiedevInstructions(config: Record<string, any>, file: string): Record<string, any>;
 export declare function buildCodieConfig({ existing, catalog, env, plugin, plugins, }: {
     existing?: Record<string, any>;
     catalog: CatalogModel[];

package/dist/codieLauncher.js

@@ -47,6 +47,7 @@ exports.usableModelCost = usableModelCost;
 exports.usableModelLimit = usableModelLimit;
 exports.withCodieWorkingDirectory = withCodieWorkingDirectory;
 exports.bareModel = bareModel;
+exports.withCodiedevInstructions = withCodiedevInstructions;
 exports.buildCodieConfig = buildCodieConfig;
 exports.stageUsageModule = stageUsageModule;
 exports.withBrandPlugin = withBrandPlugin;
@@ -140,6 +141,13 @@ function normalizeAgentModels(agents, approved, fallback) {
     }
     return normalized;
 }
+/** Add the Codiedev instructions file to OpenCode's `instructions` (kept
+ * alongside the user's own, never duplicated). Codie writes the file itself:
+ * OpenCode never sees the instruction blocks `connect` writes for other tools. */
+function withCodiedevInstructions(config, file) {
+    const current = Array.isArray(config.instructions) ? config.instructions.filter((x) => typeof x === "string") : [];
+    return { ...config, instructions: current.includes(file) ? current : [...current, file] };
+}
 function buildCodieConfig({ existing = {}, catalog, env = {}, plugin, plugins = [], }) {
     if (!Array.isArray(catalog) || catalog.length === 0) {
         throw new Error("No company-approved models were returned by Codiedev");

package/dist/commands/pack.d.ts

@@ -67,4 +67,4 @@ export interface PublishResult {
 /** `codiedev pack publish <slug> [--channel stable|beta|alpha]`: snapshot the
  * draft onto a channel. Re-running with no changes publishes nothing. */
 export declare function runPublish(config: CodiedevConfig, args: PackArgs): Promise<PublishResult>;
-export declare const PACK_HELP = "Usage:\n  codiedev pack list                     Packs assigned to your team\n  codiedev pack install [slug] [--harness claude,codex,copilot,cursor,codie,pi] [--dry-run] [--json] [--quiet]\n                                         Install one pack, or every pack that applies\n  codiedev pack status [--json]          Installed packs and whether they're up to date\n  codiedev pack export <slug> --out <dir> [--git] [--manifest]\n                                         Write the pack as a Claude-format plugin folder plus\n                                         .claude-plugin/marketplace.json (commit it for CI).\n                                         --git inits the folder and commits; --manifest writes\n                                         an editable <slug>.pack.md instead\n  codiedev pack apply <pack.md> [--publish] [--channel stable|beta|alpha] [--dry-run]\n                                         Create or update a pack from a pack.md\n                                         (--publish then publishes it, see below)\n  codiedev pack publish <slug> [--channel stable|beta|alpha]\n                                         Publish the pack's draft to a channel (default\n                                         stable). Nothing happens when it hasn't changed.\n\nFiles (scripts, PDFs, a runner folder): list them under \"## Files\" in pack.md,\none \"- <path in pack> <- <local path>\" per line (local paths are relative to\nthe pack.md; \".\" is the pack root):\n\n  ## Files\n\n  - runner <- ~/.claude/runner\n  - skills/healthcare-scan <- ~/.claude/skills/healthcare-scan\n\n`pack apply` uploads them (admins and team managers; 15MB per file, 50MB per\npack; caches, .git and hidden files are skipped). Without a \"## Files\"\nsection the pack's files are left alone. In skills, point at files relative to\nthe skill's folder, or use ${CLAUDE_PLUGIN_ROOT}/runner/...: Codiedev swaps in the\nreal path for Codex, Copilot, Cursor, pi and Codie.\n\nCursor: packs are copied to ~/.cursor/plugins/local/codiedev-<slug>/. A Cursor\nteam admin can disable \"user local plugin imports\"; then Cursor ignores them.\n\nAuto-update: session starts run `codiedev pack install --quiet` in the background\nabout once an hour. Opt out with CODIEDEV_PACK_AUTOSYNC=0.\n\nHooks for specific skills only: codiedev hook-gate --skills a,b --cmd-b64 <base64url of the command>\n(the pack editor writes this; the command runs via /bin/sh, or cmd.exe on Windows)\n\nCI: set CODIEDEV_TOKEN to a pack CI key (cdvci_\u2026, from the pack's page in the portal).\nNo `codiedev connect` or config file is needed. CI mode (a cdvci_ key, or CI=true)\nnever auto-syncs, reports or prunes, installs the one pack the key can see, defaults\n--harness to claude when it's on PATH, and exits non-zero unless every requested tool\ngot the pack. Skills from a pack are /<pack-slug>:<skill> in Claude Code.\n\n  GitLab CI (.gitlab-ci.yml; add CODIEDEV_TOKEN and ANTHROPIC_API_KEY as masked\n  CI/CD variables):\n    pack-scan:\n      image: node:22\n      script:\n        - npm i -g codiedev @anthropic-ai/claude-code\n        - codiedev pack install --harness claude\n        - claude -p \"/platform-starter:healthcare-scan\" --output-format text\n\n  GitHub Actions (repository secrets CODIEDEV_TOKEN and ANTHROPIC_API_KEY):\n    - uses: actions/setup-node@v4\n      with: { node-version: 22 }\n    - run: npm i -g codiedev @anthropic-ai/claude-code\n    - run: codiedev pack install --harness claude\n      env:\n        CODIEDEV_TOKEN: ${{ secrets.CODIEDEV_TOKEN }}\n    - run: claude -p \"/platform-starter:healthcare-scan\" --output-format text\n      env:\n        ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}\n\n  Keep a pack up to date from its repo (GitLab; on merges to main). Use a\n  personal Codiedev token of a pack owner (portal \u2192 Integrations \u2192 CLI tokens) as a\n  masked CODIEDEV_TOKEN: pack CI keys can only install, not publish.\n    pack-release:\n      image: node:22\n      rules: [{ if: '$CI_COMMIT_BRANCH == \"main\"' }]\n      script:\n        - npm i -g codiedev\n        - codiedev pack apply packs/platform-starter.pack.md --publish\n  This ships the pack's files, agents, hooks and skill list. Edits to a skill's\n  own SKILL.md still go to the library with `codiedev push`.\n\n  Or vendor the plugin into the repo instead of installing at build time:\n    codiedev pack export <slug> --out .codiedev/packs";
+export declare const PACK_HELP = "Usage:\n  codiedev pack list                     Packs assigned to your team\n  codiedev pack install [slug] [--harness claude,codex,copilot,cursor,codie,pi] [--dry-run] [--json] [--quiet]\n                                         Install one pack, or every pack that applies\n  codiedev pack status [--json]          Installed packs and whether they're up to date\n  codiedev pack export <slug> --out <dir> [--git] [--manifest]\n                                         Write the pack as a Claude-format plugin folder plus\n                                         .claude-plugin/marketplace.json (commit it for CI).\n                                         --git inits the folder and commits; --manifest writes\n                                         an editable <slug>.pack.md instead\n  codiedev pack apply <pack.md> [--publish] [--channel stable|beta|alpha] [--dry-run]\n                                         Create or update a pack from a pack.md\n                                         (--publish then publishes it, see below)\n  codiedev pack publish <slug> [--channel stable|beta|alpha]\n                                         Publish the pack's draft to a channel (default\n                                         stable). Nothing happens when it hasn't changed.\n\nFiles (scripts, PDFs, a runner folder): list them under \"## Files\" in pack.md,\none \"- <path in pack> <- <local path>\" per line (local paths are relative to\nthe pack.md; \".\" is the pack root):\n\n  ## Files\n\n  - runner <- ~/.claude/runner\n  - skills/healthcare-scan <- ~/.claude/skills/healthcare-scan\n\n`pack apply` uploads them (admins and team managers; 15MB per file, 50MB per\npack; caches, .git and hidden files are skipped). Without a \"## Files\"\nsection the pack's files are left alone. In skills, point at files relative to\nthe skill's folder, or use ${CLAUDE_PLUGIN_ROOT}/runner/...: Codiedev swaps in the\nreal path for Codex, Copilot, Cursor, pi and Codie.\n\nCursor: packs are copied to ~/.cursor/plugins/local/codiedev-<slug>/. A Cursor\nteam admin can disable \"user local plugin imports\"; then Cursor ignores them.\n\nAuto-update: session starts run `codiedev pack install --quiet` in the background\nabout once an hour. Opt out with CODIEDEV_PACK_AUTOSYNC=0.\n\nHooks for specific skills only: codiedev hook-gate --skills a,b --cmd-b64 <base64url of the command>\n(the pack editor writes this; the command runs via /bin/sh, or cmd.exe on Windows)\n\nCI: set CODIEDEV_TOKEN to a pack CI key (cdvci_\u2026, from the pack's page in the portal).\nNo `codiedev connect` or config file is needed. CI mode (a cdvci_ key, or CI=true)\nnever auto-syncs, reports or prunes, installs the one pack the key can see, defaults\n--harness to claude when it's on PATH, and exits non-zero unless every requested tool\ngot the pack. Skills from a pack are /<pack-slug>:<skill> in Claude Code.\n\n  GitLab CI (.gitlab-ci.yml; add CODIEDEV_TOKEN and ANTHROPIC_API_KEY as masked\n  CI/CD variables):\n    pack-scan:\n      image: node:22\n      script:\n        - npm i -g codiedev @anthropic-ai/claude-code\n        - codiedev pack install --harness claude\n        - claude -p \"/platform-starter:healthcare-scan\" --output-format text\n\n  GitHub Actions (repository secrets CODIEDEV_TOKEN and ANTHROPIC_API_KEY):\n    - uses: actions/setup-node@v4\n      with: { node-version: 22 }\n    - run: npm i -g codiedev @anthropic-ai/claude-code\n    - run: codiedev pack install --harness claude\n      env:\n        CODIEDEV_TOKEN: ${{ secrets.CODIEDEV_TOKEN }}\n    - run: claude -p \"/platform-starter:healthcare-scan\" --output-format text\n      env:\n        ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}\n\n  Keep a pack up to date from its repo (GitLab; on merges to main). Use a\n  personal Codiedev token of a pack owner (portal \u2192 Integrations \u2192 CLI tokens) as a\n  masked CODIEDEV_TOKEN: pack CI keys can only install, not publish.\n    pack-release:\n      image: node:22\n      rules: [{ if: '$CI_COMMIT_BRANCH == \"main\"' }]\n      script:\n        - npm i -g codiedev\n        - codiedev pack apply packs/platform-starter.pack.md --publish\n  Skills listed in pack.md as local folders (\"- ./skills/healthcare-scan\") are\n  pushed when their SKILL.md changed, and the rest of each folder ships with it.\n\n  Or vendor the plugin into the repo instead of installing at build time:\n    codiedev pack export <slug> --out .codiedev/packs";

package/dist/commands/pack.js

@@ -60,6 +60,9 @@ const sync_1 = require("../packs/sync");
 const harnesses_2 = require("../packs/harnesses");
 const os = __importStar(require("os"));
 const utils_1 = require("../utils");
+const push_1 = require("./push");
+const skillMarker_1 = require("../skillMarker");
+const localSkills_1 = require("../packs/localSkills");
 const shared_1 = require("./shared");
 const files_1 = require("../packs/files");
 // --- CI (pack-scoped `cdvci_` keys) ------------------------------------------
@@ -170,8 +173,8 @@ got the pack. Skills from a pack are /<pack-slug>:<skill> in Claude Code.
       script:
         - npm i -g codiedev
         - codiedev pack apply packs/platform-starter.pack.md --publish
-  This ships the pack's files, agents, hooks and skill list. Edits to a skill's
-  own SKILL.md still go to the library with \`codiedev push\`.
+  Skills listed in pack.md as local folders ("- ./skills/healthcare-scan") are
+  pushed when their SKILL.md changed, and the rest of each folder ships with it.
 
   Or vendor the plugin into the repo instead of installing at build time:
     codiedev pack export <slug> --out .codiedev/packs`;
@@ -667,19 +670,44 @@ async function runApply(config, args) {
     }
     if (!markdown.trim())
         throw new Error(`${file} is empty`);
+    const baseDir = path.dirname(file);
+    // SIG-128: local skills under `## Skills` are pushed, and a skill folder's
+    // other contents ship as that skill's files.
+    const skills = (0, localSkills_1.findLocalSkills)(markdown, baseDir);
     // `## Files` (SIG-127): local folders/files to ship in the plugin dir.
-    // Absent ⇒ the pack's files are left as they are.
+    // Neither a Files section nor a local skill folder ⇒ the pack's files are
+    // left as they are; otherwise this list replaces them.
     const entries = (0, files_1.parseFilesSection)(markdown);
-    const local = entries ? (0, files_1.collectLocalFiles)(entries, path.dirname(file)) : null;
-    for (const note of local?.notes ?? [])
+    const listed = new Set((entries ?? []).map((e) => e.dest.replace(/^\.\/+/, "").replace(/\/+$/, "").toLowerCase()));
+    const folderEntries = (0, localSkills_1.skillFolderEntries)(skills).filter((e) => !listed.has(e.dest.toLowerCase()));
+    const allEntries = entries || folderEntries.length ? [...(entries ?? []), ...folderEntries] : null;
+    const local = allEntries ? (0, files_1.collectLocalFiles)(allEntries, baseDir) : null;
+    const ownSkillMd = new Set(skills.map((s) => `${s.pluginDir}/SKILL.md`.toLowerCase()));
+    for (const note of local?.notes ?? []) {
+        // A local skill's own SKILL.md is pushed as the skill, not skipped.
+        if ([...ownSkillMd].some((p) => note.toLowerCase().includes(p)))
+            continue;
         console.log(`  · ${note}`);
+    }
     if (args.dryRun) {
         const extra = local ? `, ${local.files.length} file${local.files.length === 1 ? "" : "s"} (${formatBytes(local.files.reduce((n, f) => n + f.size, 0))})` : "";
         console.log(`Dry run — would apply ${file} (${Buffer.byteLength(markdown)} bytes${extra}).`);
+        for (const skill of skills)
+            console.log(`  skill ${skill.name} ← ${path.relative(baseDir, skill.skillFile) || skill.skillFile} (pushed if changed)`);
         for (const f of local?.files ?? [])
             console.log(`  ${f.path}`);
         return {};
     }
+    const keys = new Map();
+    let pushedSkills = 0;
+    for (const skill of skills) {
+        const { key, pushed } = await pushLocalSkill(config, skill);
+        keys.set(skill.line, key);
+        if (pushed)
+            pushedSkills += 1;
+    }
+    if (keys.size)
+        markdown = (0, localSkills_1.rewriteLocalSkills)(markdown, keys);
     let uploaded = 0;
     if (local?.files.length)
         uploaded = await uploadPackFiles(config, local.files);
@@ -708,6 +736,8 @@ async function runApply(config, args) {
         const verb = res.created === true ? "Created" : res.changed === false ? "No changes to" : "Updated";
         const version = typeof res.version === "number" ? ` v${res.version}` : "";
         console.log(`✓ ${verb} ${slug}${version} from ${path.basename(file)}`);
+        if (skills.length)
+            console.log(`  skills: ${skills.length} local (${pushedSkills} pushed, ${skills.length - pushedSkills} unchanged)`);
         if (local)
             console.log(`  files: ${local.files.length} (${uploaded} uploaded, ${local.files.length - uploaded} already on Codiedev)`);
         if (Array.isArray(res.warnings)) {
@@ -762,6 +792,29 @@ async function runPublish(config, args) {
         console.log(`✓ Published ${out.slug} v${out.version} to ${channel}. Teams on ${channel} get it at their next sync.`);
     return out;
 }
+/** Push a local skill unless the library already has this exact text (so CI
+ * doesn't add a version on every merge). Team-visible: packs ship to teams. */
+async function pushLocalSkill(config, skill) {
+    const local = (0, skillMarker_1.stripSkillMarker)(fs.readFileSync(skill.skillFile, "utf8"));
+    try {
+        const current = await (0, shared_1.apiRequest)("GET", "/api/cli/pull", { config, query: { key: skill.name } });
+        const remote = current.artifact?.markdown;
+        if (current.artifact?.kind === "skill" && typeof remote === "string" && (0, skillMarker_1.stripSkillMarker)(remote).trimEnd() === local.trimEnd()) {
+            return { key: skill.name, pushed: false };
+        }
+    }
+    catch (error) {
+        if (error.status !== 404)
+            throw new Error(`couldn't check skill ${skill.name} (${error.message})`);
+    }
+    try {
+        const res = await (0, push_1.pushFile)(config, { absPath: skill.skillFile, key: path.basename(skill.skillFile), kind: "skill", visibility: "team" });
+        return { key: res.key ?? skill.name, pushed: true };
+    }
+    catch (error) {
+        throw new Error(`couldn't push skill ${skill.name} (${error.message})`);
+    }
+}
 function formatBytes(n) {
     return n >= 1024 * 1024 ? `${(n / (1024 * 1024)).toFixed(1)}MB` : n >= 1024 ? `${Math.round(n / 1024)}KB` : `${n}B`;
 }

package/dist/managedPi.js

@@ -230,6 +230,9 @@ function prepareManagedPiDir(opts) {
     // extensions dropped into the dir go away on every launch.
     fs.rmSync(path.join(agentDir, "auth.json"), { force: true });
     fs.rmSync(path.join(agentDir, "extensions"), { recursive: true, force: true });
+    // pi reads <agentDir>/AGENTS.md as global context; the managed dir is ours,
+    // so the Codiedev instructions are written fresh on every launch.
+    fs.writeFileSync(path.join(agentDir, "AGENTS.md"), (0, utils_1.codiedevInstructionsText)(), { mode: 0o600 });
     const guard = path.join(agentDir, exports.GUARD_FILE);
     fs.writeFileSync(guard, exports.GUARD_SOURCE, { mode: 0o600 });
     const capture = path.join(agentDir, exports.CAPTURE_FILE);

package/dist/packs/localSkills.d.ts

@@ -0,0 +1,18 @@
+import { FilesEntry } from "./files";
+export interface LocalSkill {
+    /** 1-based line in pack.md. */
+    line: number;
+    source: string;
+    skillFile: string;
+    /** The skill folder, when the entry named one (its files ship with the skill). */
+    dir: string | null;
+    name: string;
+    /** `skills/<dir>/` in the plugin, matching the server's skillDirName. */
+    pluginDir: string;
+}
+/** Local-path lines under `## Skills` (fenced blocks are skipped). */
+export declare function findLocalSkills(markdown: string, baseDir: string, home?: string): LocalSkill[];
+/** pack.md with each local skill line replaced by `- <key> @me`. */
+export declare function rewriteLocalSkills(markdown: string, keys: Map<number, string>): string;
+/** Files entries for skill folders, so their scripts/docs ship with them. */
+export declare function skillFolderEntries(skills: LocalSkill[]): FilesEntry[];

package/dist/packs/localSkills.js

@@ -0,0 +1,130 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findLocalSkills = findLocalSkills;
+exports.rewriteLocalSkills = rewriteLocalSkills;
+exports.skillFolderEntries = skillFolderEntries;
+// SIG-128: local skills in a pack.md. Under `## Skills`, a line naming a local
+// path (`./…`, `../…`, `~/…`, `/…`) instead of `<key> @<author email>` is a
+// skill on this machine: `pack apply` pushes it to the library (only when it
+// changed) and rewrites the line to `<key> @me`. A skill FOLDER also ships
+// the rest of its contents (scripts/, docs/…) as the skill's pack files.
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const files_1 = require("./files");
+const manifest_1 = require("./manifest");
+const LOCAL = /^(\.{1,2}\/|~\/|~$|\/)/;
+/** Same rule as the server's skillDirName: the frontmatter name when it's a
+ * safe folder name, else a slug of it. */
+function pluginDirName(name) {
+    if (/^[A-Za-z0-9][A-Za-z0-9._ -]{0,127}$/.test(name) && !name.includes(".."))
+        return name;
+    const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48).replace(/-+$/g, "");
+    return slug || "pack";
+}
+/** Local-path lines under `## Skills` (fenced blocks are skipped). */
+function findLocalSkills(markdown, baseDir, home = os.homedir()) {
+    const lines = markdown.replace(/^/, "").split("\n").map((l) => l.replace(/\r$/, ""));
+    const out = [];
+    let fence = null;
+    let inSkills = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const f = line.match(/^(`{3,})/);
+        if (f) {
+            if (!fence)
+                fence = f[1];
+            else if (f[1].length >= fence.length && /^`+\s*$/.test(line))
+                fence = null;
+            continue;
+        }
+        if (fence)
+            continue;
+        const h2 = line.match(/^##\s+(.+?)\s*$/);
+        if (h2 && !line.startsWith("###")) {
+            inSkills = h2[1].toLowerCase() === "skills";
+            continue;
+        }
+        if (!inSkills)
+            continue;
+        const m = line.match(/^\s*[-*]\s+(.+?)\s*$/);
+        if (!m)
+            continue;
+        const raw = m[1].replace(/^["']|["']$/g, "");
+        if (!LOCAL.test(raw))
+            continue;
+        const abs = path.resolve(baseDir, (0, files_1.expandHome)(raw, home));
+        let stat;
+        try {
+            stat = fs.statSync(abs);
+        }
+        catch {
+            throw new Error(`pack.md line ${i + 1}: ${raw} doesn't exist`);
+        }
+        const dir = stat.isDirectory() ? abs : null;
+        const skillFile = dir ? path.join(dir, "SKILL.md") : abs;
+        if (!fs.existsSync(skillFile))
+            throw new Error(`pack.md line ${i + 1}: no SKILL.md in ${raw}`);
+        const { data } = (0, manifest_1.parseFrontmatter)(fs.readFileSync(skillFile, "utf8"));
+        const name = (data.name ?? "").trim();
+        if (!name || !(data.description ?? "").trim()) {
+            throw new Error(`pack.md line ${i + 1}: ${path.relative(baseDir, skillFile) || skillFile} needs SKILL.md frontmatter with name: and description:`);
+        }
+        out.push({ line: i + 1, source: raw, skillFile, dir, name, pluginDir: `skills/${pluginDirName(name)}` });
+    }
+    const seen = new Map();
+    for (const skill of out) {
+        const prior = seen.get(skill.name.toLowerCase());
+        if (prior)
+            throw new Error(`pack.md lines ${prior.line} and ${skill.line} both add a skill named "${skill.name}"`);
+        seen.set(skill.name.toLowerCase(), skill);
+    }
+    return out;
+}
+/** pack.md with each local skill line replaced by `- <key> @me`. */
+function rewriteLocalSkills(markdown, keys) {
+    const lines = markdown.split("\n");
+    for (const [line, key] of keys) {
+        const cr = lines[line - 1].endsWith("\r") ? "\r" : "";
+        const indent = lines[line - 1].match(/^\s*/)?.[0] ?? "";
+        lines[line - 1] = `${indent}- ${key} @me${cr}`;
+    }
+    return lines.join("\n");
+}
+/** Files entries for skill folders, so their scripts/docs ship with them. */
+function skillFolderEntries(skills) {
+    return skills.filter((s) => s.dir).map((s) => ({ dest: s.pluginDir, source: s.dir, line: s.line }));
+}

package/dist/utils.d.ts

@@ -143,6 +143,11 @@ export declare function ensureAllCodiedevHooksInstalled(): void;
 export declare function hasDirectHookPath(configText: string): boolean;
 export declare function migrateHooksToLauncher(): string[];
 export declare function ensureSessionStartHookInstalled(): void;
+export declare const CODIEDEV_INSTRUCTIONS_BODY = "## Codiedev \u2014 team artifact layer\n\nThis machine is connected to Codiedev. Teammates share specs, reviews,\ndecisions, and messages via a CLI on every dev's machine.\n\n**When the user asks to share, push, ping, check messages, or capture a\nthought, use the `codiedev` CLI via Bash:**\n\n| Intent | Command |\n|---|---|\n| \"push this spec\" / \"save this as a skill\" | `codiedev push <file.md>` |\n| \"pull X\" / \"grab the latest spec-X\" / \"what did a teammate push?\" | `codiedev pull <key>` |\n| \"delete X\" / \"remove that test push\" / \"rm spec-old\" | `codiedev delete <key>` (always confirm with the user first) |\n| \"ping a teammate about this\" / \"ask someone for their take\" / \"send them this file\" | `codiedev ping <name> \"<msg>\" [--with <key>] [--file <path>]` |\n| \"any messages?\" / \"check my inbox\" / \"what did a teammate say?\" | `codiedev inbox` |\n| \"read that reply\" / \"mark that ping read\" | `codiedev read <ping-id>` |\n| \"reply to that\" / \"tell them X\" (answering a message from `codiedev inbox`) | `codiedev reply <ping-id> \"<msg>\" [--file <path>]` (not a new ping: this threads it and marks theirs answered) |\n| \"note that X is a follow-up\" / \"remember X\" | `codiedev note \"<text>\"` |\n| \"share with a teammate\" / \"give someone access\" (no notification) | `codiedev share <key> <name> [--role read\\|edit]` |\n| \"send this to a teammate\" / \"ask someone to look at this\" | `codiedev send <key> <name> [\"<msg>\"]` |\n| \"find something about X\" / \"has anyone solved Y?\" | `codiedev search \"<query>\" [--limit N]` |\n| \"show my library\" / \"what artifacts exist?\" | `codiedev library [--scope mine\\|shared\\|all] [--kind doc\\|skill]` |\n| \"run my agent's test cases\" / \"check the dataset on model Y\" / \"run v2 of the dataset\" | `codiedev traces cases <agent> [--dataset <name> [--version <n>]] [--model <id>]` (writes cases + RUN_CASES.md + results.json; follow it, then `codiedev traces report <results.json>`) |\n| \"how are my agents doing?\" / \"what's failing this week?\" / \"show the booking agent's failed runs\" / \"why did run X fail?\" | `codiedev traces overview`; `codiedev traces runs <agent> [--failed] [--flag <issue>] [--days n]`; `codiedev traces run <run> --agent <name>` (add `--json` to read the data yourself) |\n| \"add a helpfulness 1\u20135 score\" / \"make a review queue for tone\" | `codiedev traces score-kinds add <name> --type number --min 1 --max 5`; `codiedev traces queue create <name> --scores <a,b>` |\n| \"score that run 4 for helpfulness\" / \"how is my agent scoring?\" | `codiedev traces score <run> <score> <value> [--agent <name>] [--comment <why>]`; `codiedev traces scores <agent>` |\n| \"put this week's failed runs in the review queue\" | `codiedev traces queue list`; `codiedev traces queue add <queue> --agent <name> [--failed] [--days n]` |\n| \"have a judge score 10% of my agent's runs\" / \"turn off automatic scoring\" | `codiedev traces judge <agent> --on --scores <a,b> --sample 10 [--budget 25]`; `--off`; no flags shows it |\n| \"import these test cases from a CSV\" / \"add an example to the dataset\" / \"save the dataset as a version\" | `codiedev traces import <agent> <file> --dataset <name>`; `codiedev traces add-example <agent> --dataset <name> --input \"\u2026\" [--expected \"\u2026\"]`; `codiedev traces save-version <dataset>`; `codiedev traces versions <dataset>` |\n| \"make a starter pack\" / \"add this to our pack\" / \"package these skills for my team\" | write a `<slug>.pack.md` (start from `codiedev pack export <slug> --manifest --out .` for an existing pack), then `codiedev pack apply <file> [--publish]` \u2014 see **Starter packs** below |\n| \"publish the pack\" / \"ship the pack to my team\" | `codiedev pack publish <slug> [--channel stable\\|beta\\|alpha]` |\n| \"what was the last eval on X?\" / \"file these eval results\" | `codiedev evals last <subject>` before starting a related eval; `codiedev evals report <run.json>` after each variant runs (scores only \u2014 `codiedev evals help` for the shape) |\n\n**Starter packs** (team managers and admins): a pack.md is frontmatter\n(`name:`, `slug:`, optional `description:`) then sections. Ask the user\nwhat to include, write the file, run `codiedev pack apply <file> --dry-run`\nto show them, then apply for real:\n\n```\n---\nname: \"Healthcare scan\"\nslug: \"healthcare-scan\"\n---\n\n# Healthcare scan\n\n## Skills\n\n- ./skills/healthcare-scan\n- lint.md @teammate@example.com\n\n## Files\n\n- runner <- ~/.claude/runner\n```\n\nUnder **Skills**, a local path (`./\u2026`, `~/\u2026` or `/\u2026`) to a skill folder\nor SKILL.md is pushed to the library and added, with the rest of its folder\nshipped as the skill's files; `<key> @<author email>` adds a teammate's\nlibrary skill. **Files** maps local folders to paths in the pack\n(`.` is the pack root). In skills, point at shipped files relative to the\nskill's folder or with `${CLAUDE_PLUGIN_ROOT}/\u2026`. Applying changes the\ndraft; `--publish` (or `codiedev pack publish`) sends it to the team.\n\n**Just push the file \u2014 we'll figure out where it goes.** Every artifact\nis classified into one of two kinds at upload time:\n\n- **skill** \u2014 the file has SKILL.md frontmatter (`name:` + `description:`\n  inside a `---` block). Shows on the Skills page in the portal and is\n  invokable as a slash command (`/<name>`).\n- **doc** \u2014 everything else. Lives in the library: list it with\n  `codiedev library`, fetch it with `codiedev pull <key>`.\n\nDetection is content-based, not filename-based. The filename prefix\n(`spec-` / `decision-` / `proposal-` / `bugfix-` / `review-` /\n`note-`) is preserved as a *tag* you can filter by, but it never gates\nvisibility. A SKILL-frontmatter file named `note-foo.md` still becomes\na skill.\n\nThe `codiedev push` response always says where the artifact landed \u2014\nread it back to the user so they can confirm.\n\n**Resolving \"the spec we just worked on\":**\n- If a file was recently edited in this session matching the conventions\n  above, push that file.\n- If content was drafted inline in the conversation, write it to a file\n  first (e.g., `/tmp/spec-xxx.md`) then push.\n\n**Teammate names:** first name usually works (`codiedev ping <name> ...`).\nIf ambiguous, the CLI returns candidates \u2014 retry with the full email.\n\n**Search before pushing.** For any \"save this as \u2026\" request, run\n`codiedev search \"<query>\"` first. If prior art exists, pull it and\niterate rather than duplicating.\n\n**Sharing vs sending:** `codiedev share` is silent (access only, no\nnotification). `codiedev send` both grants access AND pings the\nrecipient. Use send when the user is actively looping someone in.\n\n**Errors:**\n- \"not connected\" \u2192 user needs to run `npx codiedev connect` with their\n  API token from https://codiedev.com/portal/integrations/claude-code\n- \"ambiguous recipient\" \u2192 surface candidates to the user\n";
+/** The full Codiedev instructions (team-skill context + command table), for
+ * harnesses Codiedev launches itself (Codie, Codie's pi) rather than a
+ * user-owned instructions file. */
+export declare function codiedevInstructionsText(): string;
 export declare function installClaudeCodeInstructions(): void;
 export declare function installCodexInstructions(): void;
 export declare function copilotInstructionsPath(): string;

package/dist/utils.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DIRECT_UPLOAD_THRESHOLD_CHARS = exports.SWEEP_MIN_AGE_MS = exports.CAPTURE_THROTTLE_MS = exports.FINISH_ORPHAN_AGE_MS = exports.CLAIM_STALE_MS = exports.UPLOAD_TTL_MS = exports.MAX_UPLOAD_ATTEMPTS = exports.PI_EXTENSION_SUBCOMMANDS = exports.CONFIG_PATH = exports.codiedevStateDir = exports.piExtensionPath = exports.inspectPiExtension = void 0;
+exports.DIRECT_UPLOAD_THRESHOLD_CHARS = exports.SWEEP_MIN_AGE_MS = exports.CAPTURE_THROTTLE_MS = exports.FINISH_ORPHAN_AGE_MS = exports.CLAIM_STALE_MS = exports.UPLOAD_TTL_MS = exports.MAX_UPLOAD_ATTEMPTS = exports.CODIEDEV_INSTRUCTIONS_BODY = exports.PI_EXTENSION_SUBCOMMANDS = exports.CONFIG_PATH = exports.codiedevStateDir = exports.piExtensionPath = exports.inspectPiExtension = void 0;
 exports.readConfig = readConfig;
 exports.writeConfig = writeConfig;
 exports.writeConfigAtPath = writeConfigAtPath;
@@ -78,6 +78,7 @@ exports.ensureAllCodiedevHooksInstalled = ensureAllCodiedevHooksInstalled;
 exports.hasDirectHookPath = hasDirectHookPath;
 exports.migrateHooksToLauncher = migrateHooksToLauncher;
 exports.ensureSessionStartHookInstalled = ensureSessionStartHookInstalled;
+exports.codiedevInstructionsText = codiedevInstructionsText;
 exports.installClaudeCodeInstructions = installClaudeCodeInstructions;
 exports.installCodexInstructions = installCodexInstructions;
 exports.copilotInstructionsPath = copilotInstructionsPath;
@@ -1660,7 +1661,7 @@ const CODEX_USER_INSTRUCTIONS_PATH = path.join((0, harnessDirs_1.codexHome)(), "
 const CODEX_CONFIG_PATH = path.join((0, harnessDirs_1.codexHome)(), "config.toml");
 const CODIEDEV_INSTRUCTIONS_BEGIN = "<!-- codiedev-cli:begin -->";
 const CODIEDEV_INSTRUCTIONS_END = "<!-- codiedev-cli:end -->";
-const CODIEDEV_INSTRUCTIONS_BODY = `## Codiedev — team artifact layer
+exports.CODIEDEV_INSTRUCTIONS_BODY = `## Codiedev — team artifact layer
 
 This machine is connected to Codiedev. Teammates share specs, reviews,
 decisions, and messages via a CLI on every dev's machine.
@@ -1689,8 +1690,41 @@ thought, use the \`codiedev\` CLI via Bash:**
 | "put this week's failed runs in the review queue" | \`codiedev traces queue list\`; \`codiedev traces queue add <queue> --agent <name> [--failed] [--days n]\` |
 | "have a judge score 10% of my agent's runs" / "turn off automatic scoring" | \`codiedev traces judge <agent> --on --scores <a,b> --sample 10 [--budget 25]\`; \`--off\`; no flags shows it |
 | "import these test cases from a CSV" / "add an example to the dataset" / "save the dataset as a version" | \`codiedev traces import <agent> <file> --dataset <name>\`; \`codiedev traces add-example <agent> --dataset <name> --input "…" [--expected "…"]\`; \`codiedev traces save-version <dataset>\`; \`codiedev traces versions <dataset>\` |
+| "make a starter pack" / "add this to our pack" / "package these skills for my team" | write a \`<slug>.pack.md\` (start from \`codiedev pack export <slug> --manifest --out .\` for an existing pack), then \`codiedev pack apply <file> [--publish]\` — see **Starter packs** below |
+| "publish the pack" / "ship the pack to my team" | \`codiedev pack publish <slug> [--channel stable\\|beta\\|alpha]\` |
 | "what was the last eval on X?" / "file these eval results" | \`codiedev evals last <subject>\` before starting a related eval; \`codiedev evals report <run.json>\` after each variant runs (scores only — \`codiedev evals help\` for the shape) |
 
+**Starter packs** (team managers and admins): a pack.md is frontmatter
+(\`name:\`, \`slug:\`, optional \`description:\`) then sections. Ask the user
+what to include, write the file, run \`codiedev pack apply <file> --dry-run\`
+to show them, then apply for real:
+
+\`\`\`
+---
+name: "Healthcare scan"
+slug: "healthcare-scan"
+---
+
+# Healthcare scan
+
+## Skills
+
+- ./skills/healthcare-scan
+- lint.md @teammate@example.com
+
+## Files
+
+- runner <- ~/.claude/runner
+\`\`\`
+
+Under **Skills**, a local path (\`./…\`, \`~/…\` or \`/…\`) to a skill folder
+or SKILL.md is pushed to the library and added, with the rest of its folder
+shipped as the skill's files; \`<key> @<author email>\` adds a teammate's
+library skill. **Files** maps local folders to paths in the pack
+(\`.\` is the pack root). In skills, point at shipped files relative to the
+skill's folder or with \`\${CLAUDE_PLUGIN_ROOT}/…\`. Applying changes the
+draft; \`--publish\` (or \`codiedev pack publish\`) sends it to the team.
+
 **Just push the file — we'll figure out where it goes.** Every artifact
 is classified into one of two kinds at upload time:
 
@@ -1731,13 +1765,19 @@ recipient. Use send when the user is actively looping someone in.
   API token from https://codiedev.com/portal/integrations/claude-code
 - "ambiguous recipient" → surface candidates to the user
 `;
+/** The full Codiedev instructions (team-skill context + command table), for
+ * harnesses Codiedev launches itself (Codie, Codie's pi) rather than a
+ * user-owned instructions file. */
+function codiedevInstructionsText() {
+    return `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${exports.CODIEDEV_INSTRUCTIONS_BODY}\n`;
+}
 /**
  * Write the codiedev agent-facing docs block to the user-level Claude
  * instructions file so Claude Code picks up the commands in every session
  * (no per-repo CLAUDE.md needed). Idempotent — replaces the existing block
  * between its begin/end markers on re-run.
  */
-function writeInstructionsBlock(targetPath, body = CODIEDEV_INSTRUCTIONS_BODY) {
+function writeInstructionsBlock(targetPath, body = exports.CODIEDEV_INSTRUCTIONS_BODY) {
     const dir = path.dirname(targetPath);
     if (!fs.existsSync(dir)) {
         fs.mkdirSync(dir, { recursive: true });
@@ -1784,10 +1824,10 @@ function piInstructionsPath() {
 /** pi has no session-start output channel, so team skill context rides in
  * AGENTS.md the way it does for Copilot. */
 function installPiInstructions() {
-    writeInstructionsBlock(piInstructionsPath(), `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${CODIEDEV_INSTRUCTIONS_BODY}`);
+    writeInstructionsBlock(piInstructionsPath(), `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${exports.CODIEDEV_INSTRUCTIONS_BODY}`);
 }
 function installCopilotInstructions() {
-    writeInstructionsBlock(copilotInstructionsPath(), `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${CODIEDEV_INSTRUCTIONS_BODY}`);
+    writeInstructionsBlock(copilotInstructionsPath(), `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${exports.CODIEDEV_INSTRUCTIONS_BODY}`);
 }
 // Cursor uses .mdc rule files with YAML frontmatter (description, alwaysApply,
 // globs). `.cursorrules` is deprecated and ignored by Agent mode as of 2026.
@@ -1804,7 +1844,7 @@ function installCursorInstructions() {
     const block = CURSOR_INSTRUCTIONS_FRONTMATTER +
         CODIEDEV_INSTRUCTIONS_BEGIN +
         "\n" +
-        `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${CODIEDEV_INSTRUCTIONS_BODY}` +
+        `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${exports.CODIEDEV_INSTRUCTIONS_BODY}` +
         "\n" +
         CODIEDEV_INSTRUCTIONS_END +
         "\n";
@@ -1822,7 +1862,7 @@ function installCursorInstructions() {
             existing.slice(0, beginIdx) +
                 CODIEDEV_INSTRUCTIONS_BEGIN +
                 "\n" +
-                `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${CODIEDEV_INSTRUCTIONS_BODY}` +
+                `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${exports.CODIEDEV_INSTRUCTIONS_BODY}` +
                 "\n" +
                 CODIEDEV_INSTRUCTIONS_END +
                 existing.slice(endIdx + CODIEDEV_INSTRUCTIONS_END.length);
@@ -1833,10 +1873,10 @@ function installCursorInstructions() {
     fs.writeFileSync(CURSOR_RULES_PATH, next, "utf8");
 }
 function installedInstructionsTargets() {
-    const withTeamContext = `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${CODIEDEV_INSTRUCTIONS_BODY}`;
+    const withTeamContext = `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${exports.CODIEDEV_INSTRUCTIONS_BODY}`;
     return [
-        { path: CLAUDE_USER_INSTRUCTIONS_PATH, body: CODIEDEV_INSTRUCTIONS_BODY },
-        { path: CODEX_USER_INSTRUCTIONS_PATH, body: CODIEDEV_INSTRUCTIONS_BODY },
+        { path: CLAUDE_USER_INSTRUCTIONS_PATH, body: exports.CODIEDEV_INSTRUCTIONS_BODY },
+        { path: CODEX_USER_INSTRUCTIONS_PATH, body: exports.CODIEDEV_INSTRUCTIONS_BODY },
         { path: copilotInstructionsPath(), body: withTeamContext },
         { path: CURSOR_RULES_PATH, body: withTeamContext },
         { path: piInstructionsPath(), body: withTeamContext },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.9.86",
+  "version": "0.9.87",
   "description": "Connect Claude Code, Codex, Cursor, OpenCode, or VS Code Copilot to Codiedev for team session capture and artifact collaboration — and run the governed Codie harness",
   "bin": {
     "codiedev": "dist/cli.js",