JuliusBrussee/caveman · error · Error

binary download stalled after ${seconds}s — nothing installe

Error message

binary download stalled after ${seconds}s — nothing installed; agents still launch, traffic is NOT compressed or metered\nfix: caveman setup --install

What it means

Error "binary download stalled after ${seconds}s — nothing installed; agents still launch, traffic is NOT compressed or metered\nfix: caveman setup --install" thrown in JuliusBrussee/caveman.

Source

Thrown at packages/cli/src/index.ts:2154

  const line = `${name}  ${platform.os}/${platform.arch}  …`;
  if (interactive()) process.stderr.write(line);
  else console.error(line);
}

function installProgressComplete(
  name: string,
  platform: { os: string; arch: string },
  bytes: number,
) {
  const line = `${name}  ${platform.os}/${platform.arch}  ${(bytes / 1_000_000).toFixed(1)} MB  checksum verified`;
  if (interactive()) process.stderr.write(`\r${line}\n`);
  else console.error(line);
}

function setupInstallFailure(error: unknown, timeoutSeconds: number): never {
  if (interactive()) process.stderr.write("\n");
  if (error instanceof BinaryDownloadError && error.kind === "stalled") {
    throw new Error(`${OFF_STATES.downloadStalled(timeoutSeconds).line}\nfix: ${OFF_STATES.downloadStalled(timeoutSeconds).fix}`);
  }
  throw new Error(`${OFF_STATES.downloadUnreachable.line}\nfix: ${OFF_STATES.downloadUnreachable.fix}`);
}

function printInstallResult(
  installed: InstalledBinary[],
  platform: { os: string; arch: string },
  binDir: string,
  json: boolean,
  continuing = false,
) {
  if (json) {
    print({
      release: BINARY_RELEASE,
      platform: `${platform.os}/${platform.arch}`,
      target: binDir,
      binaries: installed,
      next: "caveman claude",

View on GitHub (pinned to 27d5a3981a)

Solutions

1. Retry caveman setup --install on a stable network; the download stalled and nothing was installed.

When it happens

Trigger: Thrown at packages/cli/src/index.ts:2154 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of JuliusBrussee/caveman@27d5a3981a (2026-08-15). Data as JSON: /api/errors/163917233a896937. Report an issue: GitHub.