paperclipai/paperclip · error · UsageError

comment requires --body or --body-file

Error message

comment requires --body or --body-file

What it means

Error "comment requires --body or --body-file" thrown in paperclipai/paperclip.

Source

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

  ]) {
    const value = readStringFlag(args, flag);
    if (value) body[field] = value;
  }
  const status = readStringFlag(args, "status");
  if (status) body.status = validateEnum(status, STATUSES, "status");

  const issue = await apiFetch(config, `/companies/${encodeURIComponent(identity.companyId)}/issues`, {
    method: "POST",
    mutating: true,
    body,
  });
  printJson({ command: "create-task", issue: issueSummary(issue) });
}

async function comment(config, args) {
  const issueRef = requireStringFlag(args, "issue");
  const bodyText = await readBody(args, "body", "body-file");
  if (!bodyText || bodyText.trim().length === 0) throw new UsageError("comment requires --body or --body-file");
  const commentBody = {
    body: bodyText,
    ...(boolFlag(args, "resume") ? { resume: true } : {}),
    ...(boolFlag(args, "reopen") ? { reopen: true } : {}),
  };
  const created = await apiFetch(config, `/issues/${encodeURIComponent(issueRef)}/comments`, {
    method: "POST",
    mutating: true,
    body: commentBody,
  });
  printJson({ command: "comment", issue: issueRef, comment: commentSummary(created) });
}

async function updateStatus(config, args) {
  const issueRef = requireStringFlag(args, "issue");
  const status = validateEnum(requireStringFlag(args, "status"), STATUSES, "status");
  const commentText = await readBody(args, "comment", "comment-file");
  const body = {

View on GitHub (pinned to 120ae5428f)

Solutions

1. Provide the comment text via --body or a file via --body-file.

When it happens

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