From b66da7019a9ae6554b67b67765fbef07c74bc803 Mon Sep 17 00:00:00 2001
From: Ilyaas Kapadia <86218345+IlyaasK@users.noreply.github.com>
Date: Tue, 18 Aug 2026 11:27:01 -0400
Subject: [PATCH] Document organization entitlements command

---
 reference/cli.mdx     |  4 ++--
 reference/cli/org.mdx | 23 +++++++++++++++++++++--
 2 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/reference/cli.mdx b/reference/cli.mdx
index d813df6..a5a61e8 100644
--- a/reference/cli.mdx
+++ b/reference/cli.mdx
@@ -61,8 +61,8 @@ kernel --version
   <Card icon="key" title="API Keys" href="/reference/cli/api-keys">
     Create, inspect, rotate, rename, and delete API keys.
   </Card>
-  <Card icon="building" title="Organization Limits" href="/reference/cli/org">
-    View and configure organization concurrency limits.
+  <Card icon="building" title="Organization" href="/reference/cli/org">
+    Inspect effective entitlements and configure concurrency limits.
   </Card>
   <Card icon="clock-rotate-left" title="Audit Logs" href="/reference/cli/audit-logs">
     Search and download organization audit logs.
diff --git a/reference/cli/org.mdx b/reference/cli/org.mdx
index d94bbad..ad928a8 100644
--- a/reference/cli/org.mdx
+++ b/reference/cli/org.mdx
@@ -1,8 +1,27 @@
 ---
-title: "Organization Limits"
+title: "Organization"
 ---
 
-Manage organization-wide concurrency limits and the default cap applied to projects without an explicit override.
+Inspect your organization's effective entitlements and manage its configurable concurrency limits.
+
+## `kernel org entitlements`
+
+Show the effective plan, feature access, and limits for the authenticated organization. These values already account for the organization's plan, trial, billing status, and overrides, so use them instead of inferring access from the plan name.
+
+```bash
+kernel org entitlements
+
+# Return the API response for scripts and agents
+kernel org entitlements --output json
+```
+
+| Flag | Description |
+|------|-------------|
+| `--output json`, `-o json` | Output the raw entitlement response. Nullable limits remain `null`, which means unlimited. |
+
+<Info>
+  This command is read-only. Use `kernel org limits set` to change the configurable default project concurrency cap.
+</Info>
 
 ## `kernel org limits get`