{
  "schema": "liskov.changelog.v1",
  "record": {
    "id": "2026-11-21-cli-organization-use-suggests-slug",
    "url": "https://changelog.liskov.proof.computer/r/2026-11-21-cli-organization-use-suggests-slug/",
    "md_url": "https://changelog.liskov.proof.computer/records/2026-11-21-cli-organization-use-suggests-slug.md",
    "json_url": "https://changelog.liskov.proof.computer/records/2026-11-21-cli-organization-use-suggests-slug.json",
    "title": "Choosing an organization by name now tells you its slug",
    "summary": "`proof liskov organization use` only accepts an organization's slug or ID. If you type its display name, the CLI now tells you the matching slug and ID to use instead of only refusing.",
    "type": "improved",
    "breaking": false,
    "components": [
      "cli"
    ],
    "status": "live",
    "live_at": "2026-11-21T17:15:01Z",
    "versions": {
      "@proof-computer/proof-cli-liskov": "0.19.0"
    },
    "credits": [
      {
        "anonymous": "a design partner"
      }
    ],
    "docs": [
      "https://docs.proof.computer/liskov/get-started/github"
    ],
    "agent": {
      "surface": "proof liskov organization use <selector>",
      "before": "A selector matching a membership's display name was refused with not_a_member and no hint.",
      "after": "Selection is still by exact ID or slug only. When the selector matches one membership's display name, the not_a_member refusal names that organization's slug and ID in the human text and in a `suggestion` field under --json.",
      "action": "Upgrade the plugin: proof plugins install @proof-computer/proof-cli-liskov@0.19.0. Then select with the suggested slug or ID.",
      "unaffected": [
        "Selection by ID or slug"
      ],
      "errors": [
        "not_a_member"
      ]
    },
    "supersedes": null,
    "body": "The CLI starts in your oldest membership, which is usually your personal\norganization. Switch with the organization's slug or ID."
  }
}
