paperclipai/paperclip · error

Profile ' ' is persona= ; use an agent prompt command or a…

Error message

Profile '${ctx.profileName}' is persona=${ctx.profile.persona}; use an agent prompt command or a board profile.

What it means

runBoardPrompt checks the profile persona; an agent profile cannot use the board prompt path because board prompts need board-level authentication and company scope.

Solutions

1. Use a board-persona profile, or run the agent prompt variant of the command.

When it happens

Trigger: Thrown at cli/src/commands/client/prompt.ts:147 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/5652d541ddc8f8eb. Report an issue: GitHub.

Appendix: source

Thrown at cli/src/commands/client/prompt.ts:147

    actor: "agent",
    agent: me,
    companyId: me.companyId,
    prompt: body,
    issueId: opts.issue,
    title: opts.title,
    wake: opts.wake !== false,
  });
  return result;
}

export async function runBoardPrompt(
  agentRef: string,
  prompt: string,
  opts: PromptOptions,
): Promise<PromptResult> {
  const ctx = resolveCommandContext(opts, { requireCompany: true });
  if (ctx.profile.persona && ctx.profile.persona !== "board") {
    throw new Error(`Profile '${ctx.profileName}' is persona=${ctx.profile.persona}; use an agent prompt command or a board profile.`);
  }
  const body = normalizePrompt(prompt);
  const query = new URLSearchParams({ companyId: ctx.companyId ?? "" });
  const agent = await ctx.api.get<Agent>(`${apiPath`/api/agents/${agentRef}`}?${query.toString()}`);
  if (!agent) throw new Error(`Agent not found: ${agentRef}`);

  return createOrCommentForAgent({
    api: ctx.api,
    actor: "board",
    agent,
    companyId: ctx.companyId ?? agent.companyId,
    prompt: body,
    issueId: opts.issue,
    title: opts.title,
    wake: opts.wake !== false,
  });
}

View on GitHub (pinned to 120ae5428f)