{
  "slug": "stripe-cli-docs-preferences-list-set-unset-and-apply-to-fetched-pages-305672e9e5ec",
  "title": "stripe-cli docs preferences list, set, unset, and apply to fetched pages",
  "tools": [
    "stripe-cli"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-07-29T17:05:23.000Z",
  "announced_at": "2026-07-29T17:05:23.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When you need Stripe documentation tailored to a preference, inspect the available values, set or unset a preference, then fetch the page with `stripe docs`. Stored preferences are added as query parameters unless already present in the page URL.",
    "examples": [
      "stripe docs prefs list",
      "stripe docs prefs set <id> <value>",
      "stripe docs <path> --no-pager --non-interactive"
    ],
    "gotchas": [
      "Version: v1.44.1",
      "<id> (required): Preference ID. `set` checks it against the available preferences; `unset` removes the stored value.",
      "<value> (required): Preference value. `set` checks it against the allowed values when the preference lists values.",
      "<path> (required): Documentation page path to read.",
      "--no-pager: Write output directly to stdout.",
      "--non-interactive: Write output directly without the interactive browser.",
      "Prerequisite: Install Stripe CLI; Stripe's quickstart documents installation options.",
      "Prerequisite: Preference values are fetched from docs.stripe.com when listing or setting; the set command validates the ID and value against that list.",
      "Prerequisite: Preferences are saved in the CLI config under the active profile.",
      "Preferences are stored in the CLI config file under the active profile and carry over between sessions.",
      "`set` validates the preference ID and value against the live list from docs.stripe.com.",
      "Preferences already present in the page URL are left untouched."
    ]
  },
  "why_it_matters": "Inspect or fetch Stripe documentation with selected documentation preferences while working on code that uses Stripe APIs.",
  "before": "Preferences could be stored in the CLI config but did not affect fetched page content; pages were fetched without them.",
  "sources": [
    "https://github.com/stripe/stripe-cli/releases/tag/v1.44.1",
    "https://github.com/stripe/stripe-cli/pull/1807",
    "https://github.com/stripe/stripe-cli/pull/1811",
    "https://github.com/stripe/stripe-cli/pull/1829",
    "https://github.com/stripe/stripe-cli/blob/v1.44.1/pkg/cmd/docs/prefs.go",
    "https://github.com/stripe/stripe-cli/blob/v1.44.1/pkg/cmd/docs/root.go",
    "https://docs.stripe.com/development/quickstart"
  ],
  "rank": 0.94024,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-20261016",
    "verdict_id": "wave1b-20261016:wave1b-20261016-4cf0e9dc68b65336-2:gate",
    "evidence_hash": "2121a17be8df03bdb80c2d1c77a3c9bd9baac2927d8eced090d724aaf1627a77"
  },
  "review": {
    "draft_hash": "a66461440f75ae96afe27f0cf08ea0acc660b1235c342fe789c86fcd1bdb61f9",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-20261016:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.94 >= 0.9; 2 needed) and Jev gave 0.75 (>= 0.6 needed)."
  }
}