paperclipai/paperclip · error · Error

Execution workspace needs a local path before Paperclip can

Error message

Execution workspace needs a local path before Paperclip can manage local runtime services

What it means

Precondition failure in recordRuntimeControlOperation (start/restart of local runtime services): the execution workspace has no local path (cwd). Managing local runtime services — start/stop/restart — requires a materialized local workspace directory, so the control action is rejected when cwd is absent.

Source

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

            }
            await reportRepairPhase("readiness_validation", "succeeded");
          } catch (error) {
            await reportRepairPhase(repairPhase, "failed");
            throw error;
          }
        } else if (action === "stop" || action === "restart") {
          await stopRuntimeServicesForExecutionWorkspace({
            db,
            executionWorkspaceId: existing.id,
            workspaceCwd,
            runtimeServiceId: selectedRuntimeServiceId,
          });
        }

        if (action === "start" || action === "restart") {
          const availableWorkspace = await ensureWorkspaceAvailable();
          if (!availableWorkspace) {
            throw new Error("Execution workspace needs a local path before Paperclip can manage local runtime services");
          }
          let startedServices;
          try {
            startedServices = await startRuntimeServicesForWorkspaceControl({
              db,
              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,

View on GitHub (pinned to a7e689b3c3)

Solutions

1. Configure a local path for the execution workspace before managing local runtime services.

When it happens

Trigger: Thrown at server/src/routes/execution-workspaces.ts:444 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/80f7fa1b32363609. Report an issue: GitHub.