codiedev 0.9.86 → 0.9.88

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

@@ -2,6 +2,7 @@ import { CodiedevConfig } from "../utils";
 import { InstallOptions, PackInstallResult, PackUninstallResult } from "../packs/install";
 import { HarnessName } from "../packs/harnesses";
 import { PackManifest } from "../packs/manifest";
+import { LocalSkill } from "../packs/localSkills";
 import { PackBundleFile } from "../packs/files";
 export declare const DEFAULT_BACKEND_URL = "https://cli.codiedev.com";
 /** CODIEDEV_TOKEN alone is enough: no ~/.codiedev/config.json needed (CI).
@@ -67,4 +68,13 @@ 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";
+/** The library key a skill name is stored under (server preferredSkillKey). */
+export declare function skillKeyFor(name: string): string;
+/** Push a local skill (and its folder's files) unless the library already
+ * has this exact text and files, so CI doesn't add a version on every merge.
+ * Team-visible: packs ship to teams. */
+export declare function pushLocalSkill(config: CodiedevConfig, skill: LocalSkill): Promise<{
+    key: string;
+    pushed: boolean;
+}>;
+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

@@ -47,6 +47,8 @@ exports.exportPluginFolder = exportPluginFolder;
 exports.runExport = runExport;
 exports.runApply = runApply;
 exports.runPublish = runPublish;
+exports.skillKeyFor = skillKeyFor;
+exports.pushLocalSkill = pushLocalSkill;
 const install_1 = require("../packs/install");
 const harnesses_1 = require("../packs/harnesses");
 const manifest_1 = require("../packs/manifest");
@@ -60,6 +62,10 @@ 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 skillFiles_1 = require("../packs/skillFiles");
+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 +176,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 +673,46 @@ async function runApply(config, args) {
     }
     if (!markdown.trim())
         throw new Error(`${file} is empty`);
-    // `## Files` (SIG-127): local folders/files to ship in the plugin dir.
-    // Absent ⇒ the pack's files are left as they are.
+    const baseDir = path.dirname(file);
+    // SIG-128: local skills under `## Skills` are pushed; a skill folder's other
+    // contents (scripts/, docs/) travel with the skill itself, so every pack
+    // that includes it ships them under skills/<name>/.
+    const skills = (0, localSkills_1.findLocalSkills)(markdown, baseDir);
+    // `## Files` (SIG-127): shared folders/files for the plugin dir (a runner).
+    // No Files section ⇒ the pack's own files are left as they are.
     const entries = (0, files_1.parseFilesSection)(markdown);
-    const local = entries ? (0, files_1.collectLocalFiles)(entries, path.dirname(file)) : null;
+    const local = entries ? (0, files_1.collectLocalFiles)(entries, baseDir) : null;
     for (const note of local?.notes ?? [])
         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) {
+            const folder = skill.dir ? (0, skillFiles_1.skillFolderFiles)(skill.skillFile) : null;
+            const files = folder && "files" in folder ? folder : null;
+            const withFiles = files?.files.length ? `, with ${files.files.length} file${files.files.length === 1 ? "" : "s"} from its folder` : "";
+            console.log(`  skill ${skill.name} ← ${path.relative(baseDir, skill.skillFile) || skill.skillFile} (pushed if changed${withFiles})`);
+            if (folder && "skipped" in folder)
+                console.log(`    ! SKILL.md only: ${folder.skipped}`);
+            for (const note of files?.notes ?? [])
+                console.log(`    · ${note}`);
+            for (const f of files?.files ?? [])
+                console.log(`    ${skill.pluginDir}/${f.path}`);
+        }
         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 +741,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,15 +797,63 @@ 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;
 }
+/** The library key a skill name is stored under (server preferredSkillKey). */
+function skillKeyFor(name) {
+    const slug = name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64).replace(/-+$/g, "");
+    return slug ? `${slug}.md` : name;
+}
+/** Push a local skill (and its folder's files) unless the library already
+ * has this exact text and files, 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"));
+    const found = skill.dir ? (0, skillFiles_1.skillFolderFiles)(skill.skillFile) : null;
+    if (found && "skipped" in found)
+        console.log(`  ! ${skill.name}: pushing SKILL.md only, ${found.skipped}. The skill keeps the files it had.`);
+    const folder = found && "files" in found ? found : null;
+    for (const note of folder?.notes ?? [])
+        console.log(`  · ${skill.name}: ${note}`);
+    const localRefs = folder ? folder.files.map(skillFiles_1.toRef) : undefined;
+    for (const key of [skillKeyFor(skill.name), skill.name]) {
+        try {
+            const current = await (0, shared_1.apiRequest)("GET", "/api/cli/pull", { config, query: { key } });
+            const remote = current.artifact?.markdown;
+            if (current.artifact?.kind === "skill" &&
+                typeof remote === "string" &&
+                (0, skillMarker_1.stripSkillMarker)(remote).trimEnd() === local.trimEnd() &&
+                (!localRefs || (0, skillFiles_1.sameFileRefs)(current.artifact.files, localRefs))) {
+                return { key: current.artifact.key ?? key, pushed: false };
+            }
+            break;
+        }
+        catch (error) {
+            if (error.status !== 404)
+                throw new Error(`couldn't check skill ${skill.name} (${error.message})`);
+        }
+    }
+    try {
+        if (folder)
+            await (0, skillFiles_1.uploadBlobs)(config, folder.files, "/api/cli/skills/files");
+        const res = await (0, push_1.pushFile)(config, {
+            absPath: skill.skillFile,
+            key: path.basename(skill.skillFile),
+            kind: "skill",
+            visibility: "team",
+            ...(localRefs ? { files: localRefs } : {}),
+        });
+        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`;
 }
-/** Upload the blobs Codiedev doesn't have yet. Returns how many were sent. */
+/** Upload the pack's own blobs Codiedev doesn't have yet. Returns how many were sent. */
 async function uploadPackFiles(config, files) {
-    const unique = [...new Map(files.map((f) => [f.sha256, f])).values()];
-    let known;
     try {
-        known = (await (0, shared_1.apiRequest)("POST", "/api/cli/packs/files/known", { config, body: { sha256s: unique.map((f) => f.sha256) } })).known ?? [];
+        return await (0, skillFiles_1.uploadBlobs)(config, files, "/api/cli/packs/files");
     }
     catch (error) {
         const e = error;
@@ -778,20 +861,5 @@ async function uploadPackFiles(config, files) {
             throw new Error(`Only admins and team managers can add files to a pack (${e.message})`);
         throw error;
     }
-    const have = new Set(known);
-    let sent = 0;
-    for (const f of unique) {
-        if (have.has(f.sha256))
-            continue;
-        const body = fs.readFileSync(f.abs);
-        try {
-            await (0, shared_1.apiRequestBytes)("POST", "/api/cli/packs/files/upload", { config, body, query: { sha256: f.sha256 } });
-        }
-        catch (error) {
-            throw new Error(`couldn't upload ${f.path} (${error.message})`);
-        }
-        sent += 1;
-    }
-    return sent;
 }
 exports.PACK_HELP = USAGE;

package/dist/commands/push.d.ts

@@ -1,4 +1,5 @@
 import { requireConfig } from "./shared";
+import { FileRef } from "../packs/skillFiles";
 interface PushResponse {
     ok: boolean;
     artifactId: string;
@@ -17,6 +18,8 @@ export interface ParsedArgs {
     force: boolean;
     as?: string;
     private?: boolean;
+    /** --no-files: push SKILL.md only; the skill keeps its current files. */
+    noFiles?: boolean;
 }
 export declare function parseArgs(args: string[]): ParsedArgs;
 export declare function pushFile(config: ReturnType<typeof requireConfig>, opts: {
@@ -28,6 +31,17 @@ export declare function pushFile(config: ReturnType<typeof requireConfig>, opts:
     kind?: string;
     tags?: string[];
     force?: boolean;
+    /** A skill folder's other files, already uploaded (uploadBlobs). Omitted =
+     *  the new version keeps the previous version's files. */
+    files?: FileRef[];
 }): Promise<PushResponse>;
+/** For a SKILL.md in its own folder: upload the folder's other files and
+ * return their refs. null = send no list (not a skill folder, or one over the
+ * limits, which is warned about): the skill keeps its current files. */
+export declare function uploadSkillFolder(config: ReturnType<typeof requireConfig>, skillFile: string, log?: (line: string) => void): Promise<{
+    files: FileRef[];
+    bytes: number;
+} | null>;
+export declare function formatBytes(n: number): string;
 export declare function runPush(args: string[]): Promise<void>;
 export {};

package/dist/commands/push.js

@@ -35,6 +35,8 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseArgs = parseArgs;
 exports.pushFile = pushFile;
+exports.uploadSkillFolder = uploadSkillFolder;
+exports.formatBytes = formatBytes;
 exports.runPush = runPush;
 const fs = __importStar(require("fs"));
 const skillMarker_1 = require("../skillMarker");
@@ -42,6 +44,7 @@ const path = __importStar(require("path"));
 const shared = __importStar(require("./shared"));
 const shared_1 = require("./shared");
 const utils_1 = require("../utils");
+const skillFiles_1 = require("../packs/skillFiles");
 const VALID_TYPES = new Set([
     "spec",
     "bugfix",
@@ -58,6 +61,7 @@ function parseArgs(args) {
     let force = false;
     let as;
     let priv = false;
+    let noFiles = false;
     const tags = [];
     for (let i = 0; i < args.length; i++) {
         const a = args[i];
@@ -91,12 +95,15 @@ function parseArgs(args) {
         else if (a === "--private") {
             priv = true;
         }
+        else if (a === "--no-files") {
+            noFiles = true;
+        }
         else if (!a.startsWith("--") && !file) {
             file = a;
         }
     }
     if (!file) {
-        console.error("Usage: codiedev push <file.md> [--as <key>] [--kind doc|skill] [--tag <name>] [--private] [--force]");
+        console.error("Usage: codiedev push <file.md> [--as <key>] [--kind doc|skill] [--tag <name>] [--private] [--force] [--no-files]");
         process.exit(1);
     }
     if (type && !VALID_TYPES.has(type)) {
@@ -118,7 +125,7 @@ function parseArgs(args) {
             process.exit(1);
         }
     }
-    return { file, type, kind, tags, force, as, private: priv };
+    return { file, type, kind, tags, force, as, private: priv, noFiles };
 }
 async function pushFile(config, opts) {
     // Never upload another artifact's identity marker (skillMarker.ts).
@@ -136,11 +143,31 @@ async function pushFile(config, opts) {
             gitRemoteUrl,
             visibility: opts.visibility,
             contentHash: opts.contentHash,
+            ...(opts.files ? { files: opts.files } : {}),
         },
     });
 }
+/** For a SKILL.md in its own folder: upload the folder's other files and
+ * return their refs. null = send no list (not a skill folder, or one over the
+ * limits, which is warned about): the skill keeps its current files. */
+async function uploadSkillFolder(config, skillFile, log = () => { }) {
+    const folder = (0, skillFiles_1.skillFolderFiles)(skillFile);
+    if (!folder)
+        return null;
+    if ("skipped" in folder) {
+        log(`  ! Pushing SKILL.md only: ${folder.skipped}. The skill keeps the files it had.`);
+        return null;
+    }
+    for (const note of folder.notes)
+        log(`  · ${note}`);
+    await (0, skillFiles_1.uploadBlobs)(config, folder.files, "/api/cli/skills/files");
+    return { files: folder.files.map(skillFiles_1.toRef), bytes: folder.bytes };
+}
+function formatBytes(n) {
+    return n >= 1024 * 1024 ? `${(n / (1024 * 1024)).toFixed(1)}MB` : n >= 1024 ? `${Math.round(n / 1024)}KB` : `${n}B`;
+}
 async function runPush(args) {
-    const { file, type, kind, tags, force, as, private: priv } = parseArgs(args);
+    const { file, type, kind, tags, force, as, private: priv, noFiles } = parseArgs(args);
     const config = (0, shared_1.requireConfig)();
     let absolute = file;
     if (!path.isAbsolute(absolute)) {
@@ -162,6 +189,8 @@ async function runPush(args) {
     const filename = as ?? path.basename(absolute);
     const start = Date.now();
     try {
+        // A skill's folder (scripts/, docs/, PDFs) travels with it.
+        const folder = !noFiles && kind !== "doc" ? await uploadSkillFolder(config, absolute, (l) => console.log(l)) : null;
         const res = await pushFile(config, {
             absPath: absolute,
             key: filename,
@@ -170,6 +199,7 @@ async function runPush(args) {
             tags,
             force,
             visibility: priv ? "private" : undefined,
+            ...(folder ? { files: folder.files } : {}),
         });
         (0, shared_1.recordAgentEvent)(config, {
             tool: "codiedev_push",
@@ -177,7 +207,10 @@ async function runPush(args) {
             latencyMs: Date.now() - start,
         });
         const tagSummary = res.tags && res.tags.length > 0 ? ` tags=[${res.tags.join(", ")}]` : "";
-        console.log(`✓ Pushed ${filename} (kind=${res.kind}${tagSummary}).`);
+        const fileSummary = folder?.files.length
+            ? `, with ${folder.files.length} file${folder.files.length === 1 ? "" : "s"} from its folder, ${formatBytes(folder.bytes)}`
+            : "";
+        console.log(`✓ Pushed ${filename} (kind=${res.kind}${tagSummary}${fileSummary}).`);
         console.log(`  Visible under: ${res.destination}`);
         // Echo the *resolved* key the server stored, not the local filename —
         // skills are keyed by their frontmatter name (so two `SKILL.md` files

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/files.d.ts

@@ -36,9 +36,13 @@ export declare function expandHome(p: string, home?: string): string;
 /** Walk each `## Files` entry. Junk (caches, VCS, editor files) is skipped
  * quietly; symlinks, hidden files and a skill folder's own SKILL.md are
  * skipped with a note. Throws on a missing source or a bad destination. */
-export declare function collectLocalFiles(entries: FilesEntry[], baseDir: string, home?: string): {
+export declare function collectLocalFiles(entries: FilesEntry[], baseDir: string, home?: string, opts?: {
+    lenient?: boolean;
+    checkAs?: (dest: string) => string;
+}): {
     files: LocalFile[];
     notes: string[];
+    total: number;
 };
 /** Only Claude Code sets ${CLAUDE_PLUGIN_ROOT}. In the copy other tools read,
  * replace it with the plugin dir's real path (forward slashes, which every

package/dist/packs/files.js

@@ -218,12 +218,15 @@ function expandHome(p, home = os.homedir()) {
 /** Walk each `## Files` entry. Junk (caches, VCS, editor files) is skipped
  * quietly; symlinks, hidden files and a skill folder's own SKILL.md are
  * skipped with a note. Throws on a missing source or a bad destination. */
-function collectLocalFiles(entries, baseDir, home = os.homedir()) {
+function collectLocalFiles(entries, baseDir, home = os.homedir(), opts = {}) {
     const files = new Map();
     const notes = [];
     let total = 0;
     const add = (dest, abs) => {
-        const problem = packFilePathProblem(dest);
+        // A skill folder's own SKILL.md is the skill itself (pushed separately).
+        if (opts.lenient && dest.toLowerCase() === "skill.md")
+            return;
+        const problem = packFilePathProblem(opts.checkAs ? opts.checkAs(dest) : dest);
         if (problem) {
             const parts = dest.split("/");
             if (parts.length === 3 && parts[0] === "skills" && parts[2].toLowerCase() === "skill.md") {
@@ -234,9 +237,18 @@ function collectLocalFiles(entries, baseDir, home = os.homedir()) {
                 notes.push(`skipped hidden file ${dest}`);
                 return;
             }
+            if (opts.lenient) {
+                // A skill folder: skip what can't ship, never fail the push.
+                notes.push(`skipped ${dest} (${problem})`);
+                return;
+            }
             throw new Error(`can't ship ${dest}: ${problem}`);
         }
         const stat = fs.statSync(abs);
+        if (stat.size > exports.PACK_FILE_MAX_BYTES && opts.lenient) {
+            notes.push(`skipped ${dest} (over ${exports.PACK_FILE_MAX_BYTES / (1024 * 1024)}MB)`);
+            return;
+        }
         if (stat.size > exports.PACK_FILE_MAX_BYTES)
             throw new Error(`${abs} is over ${exports.PACK_FILE_MAX_BYTES / (1024 * 1024)}MB`);
         const key = dest.toLowerCase();
@@ -291,11 +303,13 @@ function collectLocalFiles(entries, baseDir, home = os.homedir()) {
             throw new Error(`pack.md line ${entry.line}: ${entry.source} is not a file or folder`);
     }
     const list = [...files.values()].sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    if (opts.lenient)
+        return { files: list, notes, total };
     if (list.length > exports.PACK_MAX_FILES)
         throw new Error(`a pack holds at most ${exports.PACK_MAX_FILES} files (found ${list.length})`);
     if (total > exports.PACK_FILES_MAX_TOTAL_BYTES)
         throw new Error(`pack files total over ${exports.PACK_FILES_MAX_TOTAL_BYTES / (1024 * 1024)}MB`);
-    return { files: list, notes };
+    return { files: list, notes, total };
 }
 // ─── Portable copies ────────────────────────────────────────────────────────
 /** Only Claude Code sets ${CLAUDE_PLUGIN_ROOT}. In the copy other tools read,

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/packs/skillFiles.d.ts

@@ -0,0 +1,37 @@
+import { CodiedevConfig } from "../utils";
+import { LocalFile } from "./files";
+export type FileRef = {
+    path: string;
+    sha256: string;
+    executable?: boolean;
+};
+export declare const toRef: (f: {
+    path: string;
+    sha256: string;
+    executable?: boolean;
+}) => FileRef;
+export type SkillFolder = {
+    files: LocalFile[];
+    notes: string[];
+    bytes: number;
+}
+/** A skill folder that can't ship (over the limits): send no list, so the
+ *  skill keeps its current files, and warn. */
+ | {
+    skipped: string;
+};
+/** The other files in a SKILL.md's folder, paths relative to that folder.
+ * null when the file isn't a skill in its own folder (a repo root or the home
+ * folder is never walked). Files that can't ship are skipped with a note, so
+ * the folder never fails a push. */
+export declare function skillFolderFiles(skillFile: string, home?: string): SkillFolder | null;
+/** Same files (path, content, executable bit), order-insensitive? */
+export declare function sameFileRefs(a: FileRef[] | undefined, b: FileRef[] | undefined): boolean;
+/** Upload the blobs Codiedev doesn't have yet. `base` is
+ * /api/cli/packs/files (admins and managers) or /api/cli/skills/files (anyone).
+ * Returns how many were sent. */
+export declare function uploadBlobs(config: CodiedevConfig, files: Array<{
+    path: string;
+    sha256: string;
+    abs: string;
+}>, base: "/api/cli/packs/files" | "/api/cli/skills/files"): Promise<number>;

package/dist/packs/skillFiles.js

@@ -0,0 +1,120 @@
+"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.toRef = void 0;
+exports.skillFolderFiles = skillFolderFiles;
+exports.sameFileRefs = sameFileRefs;
+exports.uploadBlobs = uploadBlobs;
+// A skill's folder files: everything beside SKILL.md (scripts/, docs/, PDFs)
+// travels with the skill. `codiedev push` of a SKILL.md uploads them as blobs
+// and sends the list with the push; packs then ship them under
+// skills/<name>/ automatically. Blobs share the pack-file store (files.ts).
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const shared_1 = require("../commands/shared");
+const files_1 = require("./files");
+const manifest_1 = require("./manifest");
+const toRef = (f) => ({
+    path: f.path,
+    sha256: f.sha256,
+    ...(f.executable ? { executable: true } : {}),
+});
+exports.toRef = toRef;
+/** The other files in a SKILL.md's folder, paths relative to that folder.
+ * null when the file isn't a skill in its own folder (a repo root or the home
+ * folder is never walked). Files that can't ship are skipped with a note, so
+ * the folder never fails a push. */
+function skillFolderFiles(skillFile, home = os.homedir()) {
+    const abs = path.resolve(skillFile);
+    if (path.basename(abs).toLowerCase() !== "skill.md")
+        return null;
+    // Only a real skill (name: + description:) carries files.
+    let data;
+    try {
+        data = (0, manifest_1.parseFrontmatter)(fs.readFileSync(abs, "utf8")).data;
+    }
+    catch {
+        return null;
+    }
+    if (!(data.name ?? "").trim() || !(data.description ?? "").trim())
+        return null;
+    const dir = path.dirname(abs);
+    if (dir === path.resolve(home) || dir === path.parse(dir).root || fs.existsSync(path.join(dir, ".git")))
+        return null;
+    let walked;
+    try {
+        // Checked as the server does: as if under skills/<name>/ in a pack.
+        walked = (0, files_1.collectLocalFiles)([{ dest: ".", source: dir, line: 0 }], dir, home, { lenient: true, checkAs: (p) => `skills/s/${p}` });
+    }
+    catch (error) {
+        return { skipped: `couldn't read its folder (${error.message})` };
+    }
+    const files = walked.files.filter((f) => f.path.toLowerCase() !== "skill.md");
+    const bytes = files.reduce((n, f) => n + f.size, 0);
+    if (files.length > files_1.PACK_MAX_FILES || bytes > files_1.PACK_FILES_MAX_TOTAL_BYTES) {
+        return {
+            skipped: `its folder is over the limit (${files.length} files, ${(bytes / (1024 * 1024)).toFixed(1)}MB; at most ${files_1.PACK_MAX_FILES} files and ${files_1.PACK_FILES_MAX_TOTAL_BYTES / (1024 * 1024)}MB)`,
+        };
+    }
+    return { files, notes: walked.notes, bytes };
+}
+/** Same files (path, content, executable bit), order-insensitive? */
+function sameFileRefs(a, b) {
+    const key = (l) => JSON.stringify((l ?? []).map((f) => [f.path, f.sha256, !!f.executable]).sort());
+    return key(a) === key(b);
+}
+/** Upload the blobs Codiedev doesn't have yet. `base` is
+ * /api/cli/packs/files (admins and managers) or /api/cli/skills/files (anyone).
+ * Returns how many were sent. */
+async function uploadBlobs(config, files, base) {
+    const unique = [...new Map(files.map((f) => [f.sha256, f])).values()];
+    if (!unique.length)
+        return 0;
+    const have = new Set((await (0, shared_1.apiRequest)("POST", `${base}/known`, { config, body: { sha256s: unique.map((f) => f.sha256) } })).known ?? []);
+    let sent = 0;
+    for (const f of unique) {
+        if (have.has(f.sha256))
+            continue;
+        try {
+            await (0, shared_1.apiRequestBytes)("POST", `${base}/upload`, { config, body: fs.readFileSync(f.abs), query: { sha256: f.sha256 } });
+        }
+        catch (error) {
+            throw new Error(`couldn't upload ${f.path} (${error.message})`);
+        }
+        sent += 1;
+    }
+    return sent;
+}

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.88",
   "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",