paperclipai/paperclip · error · UsageError

--limit must be an integer from 1 to 100

Error message

--limit must be an integer from 1 to 100

What it means

Error "--limit must be an integer from 1 to 100" thrown in paperclipai/paperclip.

Source

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

}

function printJson(value) {
  process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
}

function validateEnum(value, allowed, label) {
  if (!allowed.has(value)) {
    throw new UsageError(`Invalid ${label}: ${value}`);
  }
  return value;
}

function parseLimit(args) {
  const raw = readStringFlag(args, "limit");
  if (!raw) return 20;
  const value = Number.parseInt(raw, 10);
  if (!Number.isInteger(value) || value <= 0 || value > 100) {
    throw new UsageError("--limit must be an integer from 1 to 100");
  }
  return value;
}

async function listAssigned(config, args) {
  const identity = await resolveIdentity(config);
  const status = readStringFlag(args, "status") || "todo,in_progress,in_review,blocked";
  const limit = parseLimit(args);
  const issues = await apiFetch(config, "/agents/me/inbox-lite");
  const allowedStatuses = new Set(status.split(",").map((entry) => entry.trim()).filter(Boolean));
  const filteredIssues = Array.isArray(issues)
    ? issues.filter((issue) => !allowedStatuses.size || allowedStatuses.has(issue?.status)).slice(0, limit)
    : [];
  printJson({
    command: "list-assigned",
    companyId: identity.companyId,
    agentId: identity.agentId,
    count: filteredIssues.length,

View on GitHub (pinned to 120ae5428f)

Solutions

1. Pass --limit as an integer between 1 and 100.

When it happens

Trigger: Thrown at packages/adapters/hermes/skills/paperclip-task-bridge/paperclip-task.mjs:217 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/6e0842f37572a0cb. Report an issue: GitHub.