paperclipai/paperclip · error · Error

Guidance body is required. Pass --file or --body.

Error message

Guidance body is required. Pass --file or --body.

What it means

Error "Guidance body is required. Pass --file or --body." thrown in paperclipai/paperclip.

Source

Thrown at cli/src/commands/pipelines.ts:292

        const ctx = resolvePipelineContext(opts);
        const pipelineId = await resolvePipelineId(ctx, pipeline);
        const result = await ctx.api.get(apiPath`/api/pipelines/${pipelineId}/documents/guidance`);
        printOutput(result, { json: ctx.json });
      })),
  );
  addPipelineOptions(
    guidance
      .command("put")
      .description("Create or replace pipeline guidance")
      .argument("<pipeline>", "Pipeline ID or key")
      .option("--file <path>", "Markdown file")
      .option("--body <markdown>", "Markdown body")
      .option("--title <title>", "Document title")
      .action((pipeline: string, opts: GuidancePutOptions) => withPipelineErrors(async () => {
        const ctx = resolvePipelineContext(opts);
        const pipelineId = await resolvePipelineId(ctx, pipeline);
        const body = opts.body ?? (opts.file ? await readFile(opts.file, "utf8") : undefined);
        if (body === undefined) throw new Error("Guidance body is required. Pass --file or --body.");
        printOutput(await ctx.api.put(apiPath`/api/pipelines/${pipelineId}/documents/guidance`, {
          title: opts.title ?? "Pipeline guidance",
          body,
        }), { json: ctx.json });
      })),
  );

  addPipelineOptions(
    pipelines
      .command("set-automation")
      .description("Set a run_routine onEnter automation on a stage")
      .argument("<pipeline>", "Pipeline ID or key")
      .requiredOption("--stage <key>", "Stage key")
      .requiredOption("--routine <id>", "Routine ID")
      .option("--note <text>", "Automation note")
      .action((pipeline: string, opts: AutomationOptions) => withPipelineErrors(async () => {
        const ctx = resolvePipelineContext(opts);
        const detail = await getPipeline(ctx, pipeline);

View on GitHub (pinned to 67001ec6eb)

When it happens

Trigger: Thrown at cli/src/commands/pipelines.ts:292 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@67001ec6eb (2026-08-12). Data as JSON: /api/errors/c9f538fe48371bfe. Report an issue: GitHub.