paperclipai/paperclip · error · Error

Execution workspace needs a local path before Paperclip can

Error message

Execution workspace needs a local path before Paperclip can run workspace commands

What it means

Precondition failure in recordRuntimeControlOperation (action 'run'): ensureWorkspaceAvailable resolved the workspace but it has no local path (cwd), which Paperclip requires to run workspace commands. The workspace row/lease exists but was never materialized on disk, so command execution cannot proceed.

Source

Thrown at server/src/routes/execution-workspaces.ts:580

                  identifier: null,
                  title: existing.name,
                }
              : null,
            agent: {
              id: actor.agentId ?? null,
              name: actor.actorType === "user" ? "Board" : "Agent",
              companyId: existing.companyId,
            },
            recorder,
          });

        if (action === "run") {
          if (!workspaceCommand || workspaceCommand.kind !== "job") {
            throw new Error("Workspace job selection is required");
          }
          const availableWorkspace = await ensureWorkspaceAvailable();
          if (!availableWorkspace) {
            throw new Error("Execution workspace needs a local path before Paperclip can run workspace commands");
          }
          return await runWorkspaceJobForControl({
            actor: {
              id: actor.agentId ?? null,
              name: actor.actorType === "user" ? "Board" : "Agent",
              companyId: existing.companyId,
            },
            issue: existing.sourceIssueId
              ? {
                  id: existing.sourceIssueId,
                  identifier: null,
                  title: existing.name,
                }
              : null,
            workspace: availableWorkspace,
            command: workspaceCommand.rawConfig,
            adapterEnv: {},
            recorder,

View on GitHub (pinned to a7e689b3c3)

Solutions

1. Configure a local path for the execution workspace before running workspace commands.

When it happens

Trigger: Thrown at server/src/routes/execution-workspaces.ts:393 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@a7e689b3c3 (2026-08-18). Data as JSON: /api/errors/106b050edba80605. Report an issue: GitHub.