codiedev 0.3.2 → 0.3.3

package/dist/connect.js

@@ -150,6 +150,13 @@ async function runConnect() {
         catch (err) {
             console.error(`\nWarning: Failed to install Claude Code hook — ${err.message}`);
         }
+        try {
+            (0, utils_1.installClaudeCodeInstructions)();
+            installed.push("Claude Code agent instructions (~/.claude/CLAUDE.md)");
+        }
+        catch (err) {
+            console.error(`\nWarning: Failed to install Claude Code instructions — ${err.message}`);
+        }
     }
     if (hasCodex) {
         try {
@@ -159,6 +166,13 @@ async function runConnect() {
         catch (err) {
             console.error(`\nWarning: Failed to install Codex hook — ${err.message}`);
         }
+        try {
+            (0, utils_1.installCodexInstructions)();
+            installed.push("Codex agent instructions (~/.codex/AGENTS.md)");
+        }
+        catch (err) {
+            console.error(`\nWarning: Failed to install Codex instructions — ${err.message}`);
+        }
     }
     if (!hasClaude && !hasCodex) {
         console.warn("\nNo Claude Code (~/.claude) or Codex (~/.codex) install detected.");

package/dist/utils.d.ts

@@ -27,6 +27,8 @@ export declare function hashToken(token: string): string;
 export declare function claudeCodeInstalled(): boolean;
 export declare function codexInstalled(): boolean;
 export declare function installHook(): void;
+export declare function installClaudeCodeInstructions(): void;
+export declare function installCodexInstructions(): void;
 /**
  * Install the CodieDev MCP server into Claude Code's user-scope config.
  * Safe to call multiple times — updates the existing entry if present.

package/dist/utils.js

@@ -42,6 +42,8 @@ exports.hashToken = hashToken;
 exports.claudeCodeInstalled = claudeCodeInstalled;
 exports.codexInstalled = codexInstalled;
 exports.installHook = installHook;
+exports.installClaudeCodeInstructions = installClaudeCodeInstructions;
+exports.installCodexInstructions = installCodexInstructions;
 exports.installClaudeCodeMcp = installClaudeCodeMcp;
 exports.installCodexMcp = installCodexMcp;
 exports.installCodexHook = installCodexHook;
@@ -189,7 +191,94 @@ function installHook() {
 // agent CLI's expected location so "npx codiedev connect" wires it up once.
 // ─────────────────────────────────────────────────────────────────────────────
 const CLAUDE_USER_CONFIG_PATH = path.join(os.homedir(), ".claude.json");
+const CLAUDE_USER_INSTRUCTIONS_PATH = path.join(os.homedir(), ".claude", "CLAUDE.md");
+const CODEX_USER_INSTRUCTIONS_PATH = path.join(os.homedir(), ".codex", "AGENTS.md");
 const CODEX_CONFIG_PATH = path.join(os.homedir(), ".codex", "config.toml");
+const CODIEDEV_INSTRUCTIONS_BEGIN = "<!-- codiedev-cli:begin -->";
+const CODIEDEV_INSTRUCTIONS_END = "<!-- codiedev-cli:end -->";
+const 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.
+
+**When the user asks to share, push, ping, check messages, or capture a
+thought, use the \`codiedev\` CLI via Bash:**
+
+| Intent | Command |
+|---|---|
+| "push this spec" / "share this with the team" | \`codiedev push <file.md>\` |
+| "pull X" / "grab the latest spec-X" / "what did Maya push?" | \`codiedev pull <key>\` |
+| "ping Nic about this" / "ask Maya for her take" | \`codiedev ping <name> "<msg>" [--with <key>]\` |
+| "any messages?" / "check my inbox" / "what did Nic say?" | \`codiedev inbox\` |
+| "read Nic's reply" / "mark that ping read" | \`codiedev read <ping-id>\` |
+| "note that X is a follow-up" / "remember X" | \`codiedev note "<text>"\` |
+| "promote the extracted spec" | \`codiedev promote <artifact-id>\` |
+
+**Filename conventions (set artifact type automatically):**
+- \`spec-*.md\` → spec
+- \`review-*.md\` → review
+- \`decision-*.md\` → decision
+- \`proposal-*.md\` → proposal
+- \`bugfix-*.md\` → bugfix
+- anything else → note
+
+**Resolving "the spec we just worked on":**
+- If a file was recently edited in this session matching the conventions
+  above, push that file.
+- If content was drafted inline in the conversation, write it to a file
+  first (e.g., \`/tmp/spec-xxx.md\`) then push.
+
+**Teammate names:** first name usually works (\`codiedev ping nic ...\`).
+If ambiguous, the CLI returns candidates — retry with the full email.
+
+**Errors:**
+- "not connected" → user needs to run \`npx codiedev connect\` with their
+  API token from https://codiedev.com/portal/integrations/claude-code
+- "ambiguous recipient" → surface candidates to the user
+`;
+/**
+ * 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) {
+    const dir = path.dirname(targetPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const block = `${CODIEDEV_INSTRUCTIONS_BEGIN}\n` +
+        CODIEDEV_INSTRUCTIONS_BODY +
+        `\n${CODIEDEV_INSTRUCTIONS_END}\n`;
+    let existing = "";
+    if (fs.existsSync(targetPath)) {
+        existing = fs.readFileSync(targetPath, "utf8");
+    }
+    const beginIdx = existing.indexOf(CODIEDEV_INSTRUCTIONS_BEGIN);
+    const endIdx = existing.indexOf(CODIEDEV_INSTRUCTIONS_END);
+    let next;
+    if (beginIdx !== -1 && endIdx !== -1 && endIdx > beginIdx) {
+        // Replace the existing block in place.
+        next =
+            existing.slice(0, beginIdx) +
+                block +
+                existing.slice(endIdx + CODIEDEV_INSTRUCTIONS_END.length);
+    }
+    else if (existing.trim()) {
+        // Append with a blank-line separator.
+        next = existing.replace(/\n*$/, "\n\n") + block;
+    }
+    else {
+        next = block;
+    }
+    fs.writeFileSync(targetPath, next, "utf8");
+}
+function installClaudeCodeInstructions() {
+    writeInstructionsBlock(CLAUDE_USER_INSTRUCTIONS_PATH);
+}
+function installCodexInstructions() {
+    writeInstructionsBlock(CODEX_USER_INSTRUCTIONS_PATH);
+}
 /**
  * Install the CodieDev MCP server into Claude Code's user-scope config.
  * Safe to call multiple times — updates the existing entry if present.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Connect Claude Code or Codex to CodieDev for org-wide session capture and artifact collaboration",
   "bin": {
     "codiedev": "./dist/cli.js",