diff --git a/apps/docs/docs/ref/cli/introduction.mdx b/apps/docs/docs/ref/cli/introduction.mdx
index bb12eea9481..e204038abae 100644
--- a/apps/docs/docs/ref/cli/introduction.mdx
+++ b/apps/docs/docs/ref/cli/introduction.mdx
@@ -11,9 +11,33 @@ hideTitle: true
   </div>
 </div>
 
-<div className="max-w-xl">
-  This reference documents every object and method available in Supabase's isomorphic JavaScript
-  library, supabase-js. You can use supabase-js to interact with your Postgres database, listen to
-  database changes, invoke Deno Edge Functions, build login and user management functionality, and
-  manage large files.
-</div>
+<RefSubLayout.EducationRow>
+  <RefSubLayout.Details>
+
+    The Supabase CLI provides tools to develop your project locally and deploy to the Supabase Platform.
+    The CLI is still under development, but it contains all the functionality for working with your Supabase projects and the Supabase Platform.
+
+    - Run Supabase locally: [`supabase start`](/docs/reference/cli/usage#supabase-start)
+    - Manage database migrations: [`supabase migration`](/docs/reference/cli/usage#supabase-migration)
+    - CI/CD for releasing to production: [`supabase db push`](/docs/reference/cli/usage#supabase-db-push)
+    - Manage your Supabase projects: [`supabase projects`](/docs/reference/cli/usage#supabase-projects)
+    - Generate types directly from your database schema: [`supabase gen types`](/docs/reference/cli/usage#supabase-gen)
+      - A [community-supported GitHub Action](https://github.com/lyqht/generate-supabase-db-types-github-action) to generate TypeScript types
+    - Shell autocomplete: [`supabase completion`](/docs/reference/cli/usage#supabase-completion)
+      - A [community-supported Fig autocomplete spec](https://fig.io/manual/supabase) for macOS terminal
+
+  </RefSubLayout.Details>
+
+  <RefSubLayout.Examples>
+
+    ### Additional links
+
+    - [Install the Supabase CLI](/docs/guides/cli)
+    - [Source code](https://github.com/supabase/cli)
+    - [Known bugs and issues](https://github.com/supabase/cli/issues)
+    - [Supabase CLI v1 and Management API Beta](https://supabase.com/blog/supabase-cli-v1-and-admin-api-beta)
+    - [Video: Announcing CLI V1 and Management API Beta](https://www.youtube.com/watch?v=OpPOaJI_Z28)
+
+  </RefSubLayout.Examples>
+
+</RefSubLayout.EducationRow>