Document organization entitlements command

[IlyaasK]

What

• broaden the CLI Organization page from concurrency limits to organization controls
• document kernel org entitlements and its JSON output
• explain that effective values already include plan, trial, billing-status, and organization-override policy
• clarify that nullable limits remain null in JSON and mean unlimited
• update the CLI landing card to include entitlements

Why

CLI PR kernel/cli#232 adds the read-only entitlements command. The public CLI reference currently documents only kernel org limits, so users and agents would not discover the new command from the docs site.

The generated API reference already documents GET /org/entitlements; this PR only adds the missing CLI guidance and does not duplicate the API schema.

How

The existing reference/cli/org page remains the single Organization reference. It now distinguishes the read-only effective entitlement projection from the mutable limits commands. No new navigation entry or page hierarchy is needed.

Verification

Before:

• the Organization page and CLI landing card mentioned only concurrency limits

After:

• npx --yes mint broken-links passes with no broken links
• mint dev --port 3102 starts successfully
• /reference/cli/org renders the entitlements command, unlimited semantics, and existing limits documentation
• /reference/cli renders the updated Organization card
• jq empty docs.json and git diff --check pass

Dependency

Merge after kernel/cli#232, so the public docs do not advertise an unreleased command.

KERNEL-1713

---

Note

Low Risk
Documentation-only changes with no runtime, API, or security impact.

Overview
Updates the public CLI reference so the Organization docs match the new read-only kernel org entitlements command (CLI PR kernel/cli#232).

The reference/cli/org page is retitled from "Organization Limits" to Organization and now leads with kernel org entitlements, including --output json, guidance to use effective values (plan, trial, billing, overrides) instead of inferring from plan name, and that null limits mean unlimited. Existing kernel org limits get/set content stays, with a note that entitlements are read-only and limits remain mutable via kernel org limits set.

The reference/cli landing card is updated to point at the broader Organization page and mention entitlements plus concurrency limits.

^{Reviewed by Cursor Bugbot for commit b66da70. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Kernel	🟢 Ready	View Preview	Aug 18, 2026, 3:28 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[cursor]

Risk Assessment: Very Low

This PR is documentation-only. The diff touches two Mintlify MDX files (reference/cli.mdx, reference/cli/org.mdx): it retitles the Organization CLI card and documents the read-only kernel org entitlements command plus JSON/null-means-unlimited semantics.

• Codepaths / blast radius: Public docs copy only. No application code, APIs, auth, billing, config, or infrastructure.
• Complexity: Small, local Markdown/MDX edits (~23 additions / 4 deletions).
• Operational / security impact: None. Docs do not change product behavior.
• CODEOWNERS: No CODEOWNERS file in this repo; no ownership gate blocking approval.

Decision: Approve. Very Low risk, not previously approved.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[masnwilliams]

reviewed the full diff for structural complexity, abstraction quality, maintainability, documentation accuracy, and consistency with the CLI implementation and API schema. no actionable findings.