paperclipai/paperclip · error · UsageError

Unknown command: ${command}

Error message

Unknown command: ${command}

What it means

Error "Unknown command: ${command}" thrown in paperclipai/paperclip.

Source

Thrown at packages/adapters/hermes/skills/paperclip-task-bridge/paperclip-task.mjs:331

    mutating: true,
    body,
  });
  printJson({ command: "update-status", issue: issueSummary(issue) });
}

async function main() {
  const args = parseArgs(process.argv.slice(2));
  const command = args._[0];
  if (!command || command === "help" || command === "--help" || boolFlag(args, "help")) {
    process.stdout.write(`${HELP}\n`);
    return;
  }
  const config = getConfig();
  if (command === "list-assigned") return listAssigned(config, args);
  if (command === "create-task") return createTask(config, args);
  if (command === "comment") return comment(config, args);
  if (command === "update-status") return updateStatus(config, args);
  throw new UsageError(`Unknown command: ${command}`);
}

main().catch((err) => {
  if (err instanceof UsageError) {
    process.stderr.write(`Usage error: ${err.message}\n\n${HELP}\n`);
    process.exitCode = 2;
    return;
  }
  if (err instanceof ApiError) {
    printJson({
      error: err.message,
      status: err.status,
      details: err.body?.details ?? null,
    });
    process.exitCode = 1;
    return;
  }
  process.stderr.write(`Unexpected error: ${err instanceof Error ? err.message : String(err)}\n`);

View on GitHub (pinned to 120ae5428f)

Solutions

1. Run with --help to list supported commands and use one of them.

When it happens

Trigger: Thrown at packages/adapters/hermes/skills/paperclip-task-bridge/paperclip-task.mjs:331 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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