paperclipai/paperclip · error · UsageError

--assignee-agent-id must be a UUID, self, or omitted

Error message

--assignee-agent-id must be a UUID, self, or omitted

What it means

Error "--assignee-agent-id must be a UUID, self, or omitted" thrown in paperclipai/paperclip.

Source

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

    agentId: identity.agentId,
    count: filteredIssues.length,
    issues: filteredIssues.map(issueSummary),
  });
}

async function createTask(config, args) {
  const identity = await resolveIdentity(config);
  const title = requireStringFlag(args, "title");
  const description = await readBody(args, "description", "description-file");
  const unassigned = boolFlag(args, "unassigned");
  const assigneeRaw = readStringFlag(args, "assignee-agent-id");
  const assigneeAgentId = unassigned
    ? undefined
    : !assigneeRaw || assigneeRaw === "self"
      ? identity.agentId
      : assigneeRaw;
  if (assigneeAgentId !== undefined && !UUID_RE.test(assigneeAgentId)) {
    throw new UsageError("--assignee-agent-id must be a UUID, self, or omitted");
  }
  const priority = readStringFlag(args, "priority") ?? "medium";
  const workMode = readStringFlag(args, "work-mode") ?? "standard";
  validateEnum(priority, PRIORITIES, "priority");
  validateEnum(workMode, WORK_MODES, "work mode");
  const body = {
    title,
    description,
    priority,
    workMode,
    ...(assigneeAgentId !== undefined ? { assigneeAgentId } : {}),
  };
  for (const [flag, field] of [
    ["parent-id", "parentId"],
    ["goal-id", "goalId"],
    ["project-id", "projectId"],
  ]) {
    const value = readStringFlag(args, flag);

View on GitHub (pinned to 120ae5428f)

Solutions

1. Pass --assignee-agent-id as a valid UUID, the literal 'self', or omit it.

When it happens

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