@parall/claude-agent 1.22.0 → 1.24.0

package/dist/dispatch.d.ts

@@ -10,7 +10,7 @@ export declare function buildSpawnEnv(parentEnv: NodeJS.ProcessEnv, claudeHome:
 export declare class ClaudeCodeAdapter implements DispatchAdapter {
     private readonly opts;
     constructor(opts: ClaudeCodeAdapterOptions);
-    dispatch({ bodyForAgent, sessionKey, context }: DispatchOpts): AsyncIterable<RuntimeEvent>;
+    dispatch({ event, bodyForAgent, sessionKey, context }: DispatchOpts): AsyncIterable<RuntimeEvent>;
     forkSession({ sessionKey }: ForkOpts): import("@parall/agent-core").ForkSessionHandle | null;
     cleanupFork({ fork }: CleanupForkOpts): void;
     private buildArgs;

package/dist/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,KAAK,wBAAwB,GAAG,IAAI,CAClC,iBAAiB,EACf,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,OAAO,GACP,gBAAgB,GAChB,cAAc,CACjB,GAAG;IACF,cAAc,EAAE,oBAAoB,CAAC;CACtC,CAAC;AAEF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,CAAC,UAAU,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,GAC7B,MAAM,CAAC,UAAU,CAuBnB;AAED,qBAAa,iBAAkB,YAAW,eAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAEpD,QAAQ,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IA+EjG,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ;IAIpC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe;IAIrC,OAAO,CAAC,SAAS;CAkClB"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,KAAK,wBAAwB,GAAG,IAAI,CAClC,iBAAiB,EACf,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,OAAO,GACP,gBAAgB,GAChB,cAAc,CACjB,GAAG;IACF,cAAc,EAAE,oBAAoB,CAAC;CACtC,CAAC;AAEF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,CAAC,UAAU,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,GAC7B,MAAM,CAAC,UAAU,CAuBnB;AAED,qBAAa,iBAAkB,YAAW,eAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAEpD,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IAkGxG,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ;IAIpC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe;IAIrC,OAAO,CAAC,SAAS;CAkClB"}

package/dist/dispatch.js

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
+import { appendPreparedLocalAttachmentRefs, pinLocalAttachmentPaths, } from "@parall/agent-core/internal/attachment-input";
 import { parseClaudeStreamJson } from "./output-parser.js";
 export function buildSpawnEnv(parentEnv, claudeHome, context, opts) {
     const env = { ...parentEnv };
@@ -30,73 +31,91 @@ export class ClaudeCodeAdapter {
     constructor(opts) {
         this.opts = opts;
     }
-    async *dispatch({ bodyForAgent, sessionKey, context }) {
-        const args = this.buildArgs(sessionKey, bodyForAgent);
-        const env = buildSpawnEnv(process.env, this.opts.claudeHome, context, {
-            allowApiKey: this.opts.allowApiKey,
-        });
-        context.log?.info(`claude-agent[${context.accountId}]: spawn ${this.opts.claudeBin} ${args.slice(0, -1).join(" ")}`);
-        const proc = spawn(this.opts.claudeBin, args, {
-            cwd: this.opts.workspaceDir,
-            env,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        if (!proc.stdout || !proc.stderr) {
-            throw new Error("Claude subprocess did not provide stdio pipes");
+    async *dispatch({ event, bodyForAgent, sessionKey, context }) {
+        let promptBody = bodyForAgent;
+        let releasePreparedAttachments = () => { };
+        try {
+            const prepared = await appendPreparedLocalAttachmentRefs(bodyForAgent, event, context, {
+                workspaceDir: this.opts.workspaceDir,
+                log: context.log,
+            });
+            promptBody = prepared.body;
+            releasePreparedAttachments = pinLocalAttachmentPaths(prepared.attachments.images);
+        }
+        catch (err) {
+            context.log?.warn?.(`claude-agent[${context.accountId}]: failed to prepare local attachments: ${String(err)}`);
         }
-        const stderr = [];
-        proc.stderr.on("data", (chunk) => {
-            stderr.push(chunk.toString());
-        });
-        const exitPromise = new Promise((resolve, reject) => {
-            proc.once("error", reject);
-            proc.once("close", (code, signal) => resolve({ code, signal }));
-        });
-        const groupKey = randomUUID();
-        let sawError = false;
-        let completed = false;
         try {
-            for await (const event of parseClaudeStreamJson(proc.stdout)) {
-                if (event.type === "session_id") {
-                    this.opts.sessionManager.recordSessionId(sessionKey, event.sessionId);
-                    continue;
+            const args = this.buildArgs(sessionKey, promptBody);
+            const env = buildSpawnEnv(process.env, this.opts.claudeHome, context, {
+                allowApiKey: this.opts.allowApiKey,
+            });
+            context.log?.info(`claude-agent[${context.accountId}]: spawn ${this.opts.claudeBin} ${args.slice(0, -1).join(" ")}`);
+            const proc = spawn(this.opts.claudeBin, args, {
+                cwd: this.opts.workspaceDir,
+                env,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            if (!proc.stdout || !proc.stderr) {
+                throw new Error("Claude subprocess did not provide stdio pipes");
+            }
+            const stderr = [];
+            proc.stderr.on("data", (chunk) => {
+                stderr.push(chunk.toString());
+            });
+            const exitPromise = new Promise((resolve, reject) => {
+                proc.once("error", reject);
+                proc.once("close", (code, signal) => resolve({ code, signal }));
+            });
+            const groupKey = randomUUID();
+            let sawError = false;
+            let completed = false;
+            try {
+                for await (const streamEvent of parseClaudeStreamJson(proc.stdout)) {
+                    if (streamEvent.type === "session_id") {
+                        this.opts.sessionManager.recordSessionId(sessionKey, streamEvent.sessionId);
+                        continue;
+                    }
+                    if (streamEvent.type === "error") {
+                        sawError = true;
+                        yield streamEvent;
+                        continue;
+                    }
+                    if (streamEvent.type === "text") {
+                        // Runtime output contract (symmetric with OpenClaw channel): Claude's
+                        // plain text is never projected as a chat message. To reply, the agent
+                        // must explicitly run `parall messages send` / `dm` via Bash. Text
+                        // events are still recorded as suppressed session steps for audit.
+                        yield {
+                            ...streamEvent,
+                            project: false,
+                            groupKey,
+                        };
+                        continue;
+                    }
+                    yield {
+                        ...streamEvent,
+                        groupKey,
+                    };
                 }
-                if (event.type === "error") {
-                    sawError = true;
-                    yield event;
-                    continue;
+                completed = true;
+            }
+            finally {
+                if (!completed && proc.exitCode === null && proc.signalCode === null) {
+                    proc.kill("SIGTERM");
                 }
-                if (event.type === "text") {
-                    // Runtime output contract (symmetric with OpenClaw channel): Claude's
-                    // plain text is never projected as a chat message. To reply, the agent
-                    // must explicitly run `parall messages send` / `dm` via Bash. Text
-                    // events are still recorded as suppressed session steps for audit.
+                const { code, signal } = await exitPromise;
+                if ((code ?? 0) !== 0 && !sawError) {
+                    const detail = stderr.join("").trim();
                     yield {
-                        ...event,
-                        project: false,
-                        groupKey,
+                        type: "error",
+                        message: detail || `Claude exited with code ${code ?? "unknown"}${signal ? ` (${signal})` : ""}`,
                     };
-                    continue;
                 }
-                yield {
-                    ...event,
-                    groupKey,
-                };
             }
-            completed = true;
         }
         finally {
-            if (!completed && proc.exitCode === null && proc.signalCode === null) {
-                proc.kill("SIGTERM");
-            }
-            const { code, signal } = await exitPromise;
-            if ((code ?? 0) !== 0 && !sawError) {
-                const detail = stderr.join("").trim();
-                yield {
-                    type: "error",
-                    message: detail || `Claude exited with code ${code ?? "unknown"}${signal ? ` (${signal})` : ""}`,
-                };
-            }
+            releasePreparedAttachments();
         }
     }
     forkSession({ sessionKey }) {

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import * as os from "node:os";
 import { ParallAgentGateway, parseShutdownDeadlineMs } from "@parall/agent-core";
-import { ParallClient, ParallWs } from "@parall/sdk";
+import { ApiError, ParallClient, ParallWs } from "@parall/sdk";
 import { buildClaudeRuntimeKey, resolveClaudeAgentConfig, resolveWsUrl, sessionStateFilePathForRuntime, stepIdFilePathForSession, } from "./config.js";
 import { ClaudeCodeAdapter } from "./dispatch.js";
 import { ClaudeSessionManager } from "./session-manager.js";
@@ -13,6 +13,18 @@ function createLogger(prefix) {
         error: (msg) => console.error(`[${prefix}] ${msg}`),
     };
 }
+async function getAgentMeWithLegacyFallback(client, orgId) {
+    try {
+        return await client.getAgentMe(orgId);
+    }
+    catch (err) {
+        if (!(err instanceof ApiError && err.status === 404)) {
+            throw err;
+        }
+        const user = await client.getMe();
+        return { ...user, agent_profile: null };
+    }
+}
 async function main() {
     const config = resolveClaudeAgentConfig(process.env);
     const log = createLogger("claude-agent");
@@ -28,9 +40,13 @@ async function main() {
         token: config.apiKey,
         swimlaneName: config.swimlaneName,
     });
-    const me = await client.getMe();
+    const me = await getAgentMeWithLegacyFallback(client, config.orgId);
     const agentUserId = me.id;
-    ensureClaudeWorkspace(config.workspaceDir, log, { userId: agentUserId, displayName: me.display_name });
+    ensureClaudeWorkspace(config.workspaceDir, log, {
+        userId: agentUserId,
+        displayName: me.display_name,
+        description: me.agent_profile?.description ?? undefined,
+    });
     const runtimeKey = config.runtimeKey || buildClaudeRuntimeKey(agentUserId);
     const sessionStateFilePath = sessionStateFilePathForRuntime(config.stateDir, runtimeKey);
     const sessionManager = new ClaudeSessionManager(runtimeKey, sessionStateFilePath, log);

package/dist/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,EACrC,aAAa,CAAC,EAAE,aAAa,QAgC9B"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,EACrC,aAAa,CAAC,EAAE,aAAa,QAiC9B"}

package/dist/workspace.js

@@ -1,6 +1,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { BRIDGE_WORKSPACE_INSTRUCTIONS, PRLL_BEHAVIOR, PRLL_REFERENCE_GUIDE, buildIdentity, } from "@parall/agent-core";
+import { ensureLocalAttachmentGitExclude } from "@parall/agent-core/internal/attachment-input";
 export function ensureClaudeWorkspace(workspaceDir, log, agentIdentity) {
     const CLAUDE_MD = [
         buildIdentity(agentIdentity),
@@ -30,4 +31,5 @@ export function ensureClaudeWorkspace(workspaceDir, log, agentIdentity) {
         }
     }
     fs.writeFileSync(claudeMdPath, CLAUDE_MD, "utf8");
+    ensureLocalAttachmentGitExclude(workspaceDir);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/claude-agent",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "description": "Claude Code bridge runtime for self-hosted Parall agents",
   "license": "MIT",
   "repository": {
@@ -25,9 +25,9 @@
     "src"
   ],
   "dependencies": {
-    "@parall/cli": "1.22.0",
-    "@parall/sdk": "1.22.0",
-    "@parall/agent-core": "1.22.0"
+    "@parall/agent-core": "1.24.0",
+    "@parall/cli": "1.24.0",
+    "@parall/sdk": "1.24.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/dispatch.ts

@@ -1,5 +1,9 @@
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
+import {
+  appendPreparedLocalAttachmentRefs,
+  pinLocalAttachmentPaths,
+} from "@parall/agent-core/internal/attachment-input";
 import type {
   CleanupForkOpts,
   DispatchAdapter,
@@ -60,82 +64,101 @@ export function buildSpawnEnv(
 export class ClaudeCodeAdapter implements DispatchAdapter {
   constructor(private readonly opts: ClaudeCodeAdapterOptions) {}
 
-  async *dispatch({ bodyForAgent, sessionKey, context }: DispatchOpts): AsyncIterable<RuntimeEvent> {
-    const args = this.buildArgs(sessionKey, bodyForAgent);
-    const env = buildSpawnEnv(process.env, this.opts.claudeHome, context, {
-      allowApiKey: this.opts.allowApiKey,
-    });
-
-    context.log?.info(`claude-agent[${context.accountId}]: spawn ${this.opts.claudeBin} ${args.slice(0, -1).join(" ")}`);
-
-    const proc = spawn(this.opts.claudeBin, args, {
-      cwd: this.opts.workspaceDir,
-      env,
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-
-    if (!proc.stdout || !proc.stderr) {
-      throw new Error("Claude subprocess did not provide stdio pipes");
+  async *dispatch({ event, bodyForAgent, sessionKey, context }: DispatchOpts): AsyncIterable<RuntimeEvent> {
+    let promptBody = bodyForAgent;
+    let releasePreparedAttachments = () => {};
+    try {
+      const prepared = await appendPreparedLocalAttachmentRefs(bodyForAgent, event, context, {
+        workspaceDir: this.opts.workspaceDir,
+        log: context.log,
+      });
+      promptBody = prepared.body;
+      releasePreparedAttachments = pinLocalAttachmentPaths(prepared.attachments.images);
+    } catch (err) {
+      context.log?.warn?.(
+        `claude-agent[${context.accountId}]: failed to prepare local attachments: ${String(err)}`,
+      );
     }
 
-    const stderr: string[] = [];
-    proc.stderr.on("data", (chunk) => {
-      stderr.push(chunk.toString());
-    });
+    try {
+      const args = this.buildArgs(sessionKey, promptBody);
+      const env = buildSpawnEnv(process.env, this.opts.claudeHome, context, {
+        allowApiKey: this.opts.allowApiKey,
+      });
 
-    const exitPromise = new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {
-      proc.once("error", reject);
-      proc.once("close", (code, signal) => resolve({ code, signal }));
-    });
+      context.log?.info(`claude-agent[${context.accountId}]: spawn ${this.opts.claudeBin} ${args.slice(0, -1).join(" ")}`);
 
-    const groupKey = randomUUID();
-    let sawError = false;
-    let completed = false;
+      const proc = spawn(this.opts.claudeBin, args, {
+        cwd: this.opts.workspaceDir,
+        env,
+        stdio: ["ignore", "pipe", "pipe"],
+      });
 
-    try {
-      for await (const event of parseClaudeStreamJson(proc.stdout)) {
-        if (event.type === "session_id") {
-          this.opts.sessionManager.recordSessionId(sessionKey, event.sessionId);
-          continue;
-        }
+      if (!proc.stdout || !proc.stderr) {
+        throw new Error("Claude subprocess did not provide stdio pipes");
+      }
 
-        if (event.type === "error") {
-          sawError = true;
-          yield event;
-          continue;
-        }
+      const stderr: string[] = [];
+      proc.stderr.on("data", (chunk) => {
+        stderr.push(chunk.toString());
+      });
+
+      const exitPromise = new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {
+        proc.once("error", reject);
+        proc.once("close", (code, signal) => resolve({ code, signal }));
+      });
+
+      const groupKey = randomUUID();
+      let sawError = false;
+      let completed = false;
+
+      try {
+        for await (const streamEvent of parseClaudeStreamJson(proc.stdout)) {
+          if (streamEvent.type === "session_id") {
+            this.opts.sessionManager.recordSessionId(sessionKey, streamEvent.sessionId);
+            continue;
+          }
+
+          if (streamEvent.type === "error") {
+            sawError = true;
+            yield streamEvent;
+            continue;
+          }
+
+          if (streamEvent.type === "text") {
+            // Runtime output contract (symmetric with OpenClaw channel): Claude's
+            // plain text is never projected as a chat message. To reply, the agent
+            // must explicitly run `parall messages send` / `dm` via Bash. Text
+            // events are still recorded as suppressed session steps for audit.
+            yield {
+              ...streamEvent,
+              project: false,
+              groupKey,
+            };
+            continue;
+          }
 
-        if (event.type === "text") {
-          // Runtime output contract (symmetric with OpenClaw channel): Claude's
-          // plain text is never projected as a chat message. To reply, the agent
-          // must explicitly run `parall messages send` / `dm` via Bash. Text
-          // events are still recorded as suppressed session steps for audit.
           yield {
-            ...event,
-            project: false,
+            ...streamEvent,
             groupKey,
           };
-          continue;
         }
-
-        yield {
-          ...event,
-          groupKey,
-        };
+        completed = true;
+      } finally {
+        if (!completed && proc.exitCode === null && proc.signalCode === null) {
+          proc.kill("SIGTERM");
+        }
+        const { code, signal } = await exitPromise;
+        if ((code ?? 0) !== 0 && !sawError) {
+          const detail = stderr.join("").trim();
+          yield {
+            type: "error",
+            message: detail || `Claude exited with code ${code ?? "unknown"}${signal ? ` (${signal})` : ""}`,
+          };
+        }
       }
-      completed = true;
     } finally {
-      if (!completed && proc.exitCode === null && proc.signalCode === null) {
-        proc.kill("SIGTERM");
-      }
-      const { code, signal } = await exitPromise;
-      if ((code ?? 0) !== 0 && !sawError) {
-        const detail = stderr.join("").trim();
-        yield {
-          type: "error",
-          message: detail || `Claude exited with code ${code ?? "unknown"}${signal ? ` (${signal})` : ""}`,
-        };
-      }
+      releasePreparedAttachments();
     }
   }
 

package/src/index.ts

@@ -2,7 +2,7 @@
 
 import * as os from "node:os";
 import { ParallAgentGateway, parseShutdownDeadlineMs } from "@parall/agent-core";
-import { ParallClient, ParallWs } from "@parall/sdk";
+import { ApiError, ParallClient, ParallWs } from "@parall/sdk";
 import {
   buildClaudeRuntimeKey,
   resolveClaudeAgentConfig,
@@ -22,6 +22,18 @@ function createLogger(prefix: string) {
   };
 }
 
+async function getAgentMeWithLegacyFallback(client: ParallClient, orgId: string) {
+  try {
+    return await client.getAgentMe(orgId);
+  } catch (err) {
+    if (!(err instanceof ApiError && err.status === 404)) {
+      throw err;
+    }
+    const user = await client.getMe();
+    return { ...user, agent_profile: null };
+  }
+}
+
 async function main() {
   const config = resolveClaudeAgentConfig(process.env);
   const log = createLogger("claude-agent");
@@ -44,9 +56,13 @@ async function main() {
     swimlaneName: config.swimlaneName,
   });
 
-  const me = await client.getMe();
+  const me = await getAgentMeWithLegacyFallback(client, config.orgId);
   const agentUserId = me.id;
-  ensureClaudeWorkspace(config.workspaceDir, log, { userId: agentUserId, displayName: me.display_name });
+  ensureClaudeWorkspace(config.workspaceDir, log, {
+    userId: agentUserId,
+    displayName: me.display_name,
+    description: me.agent_profile?.description ?? undefined,
+  });
   const runtimeKey = config.runtimeKey || buildClaudeRuntimeKey(agentUserId);
   const sessionStateFilePath = sessionStateFilePathForRuntime(config.stateDir, runtimeKey);
   const sessionManager = new ClaudeSessionManager(

package/src/workspace.ts

@@ -7,6 +7,7 @@ import {
   buildIdentity,
 } from "@parall/agent-core";
 import type { AgentIdentity } from "@parall/agent-core";
+import { ensureLocalAttachmentGitExclude } from "@parall/agent-core/internal/attachment-input";
 
 export function ensureClaudeWorkspace(
   workspaceDir: string,
@@ -43,4 +44,5 @@ export function ensureClaudeWorkspace(
     }
   }
   fs.writeFileSync(claudeMdPath, CLAUDE_MD, "utf8");
+  ensureLocalAttachmentGitExclude(workspaceDir);
 }