From cf777a0a27b7c3a26bac4382dd4591379aa83add Mon Sep 17 00:00:00 2001
From: jayhack <jayhack.0@gmail.com>
Date: Mon, 15 Sep 2025 16:44:38 -0700
Subject: [PATCH 1/2] .

---
 docs/introduction/cli.mdx             | 35 ++++++++++--------
 docs/sandboxes/overview.mdx           | 51 +++++++++++++++++++++++++--
 docs/settings/model-configuration.mdx | 17 ++++++++-
 docs/settings/repo-rules.mdx          |  8 +++++
 4 files changed, 94 insertions(+), 17 deletions(-)

diff --git a/docs/introduction/cli.mdx b/docs/introduction/cli.mdx
index 16bc5dac1..30da2482f 100644
--- a/docs/introduction/cli.mdx
+++ b/docs/introduction/cli.mdx
@@ -7,14 +7,16 @@ iconType: "solid"
 
 The `codegen` CLI is your terminal interface to Codegen agents. Use it to view agents, pull their work, create new agents, and run Claude Code with full telemetry and monitoring.
 
-<iframe
-  className="w-full aspect-video rounded-xl"
-  src="https://youtube.com/embed/sQ2XOonma0w"
-  title="YouTube video player"
-  frameBorder="0"
-  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
-  allowFullScreen
-></iframe>
+<Frame>
+  <video
+    controls
+    src="https://res.cloudinary.com/dbikr6pew/video/upload/v1757974837/CLI_pzot3r.mp4"
+    allowFullScreen
+    className="aspect-[3840/2160]"
+  />
+</Frame>
+
+It also wraps your local Claude Code, surfaces traces in the web UI for remote telemetry and analytics, and provides access to your Codegen integrations via MCP injection.
 
 ## Installation & Setup
 
@@ -59,6 +61,17 @@ codegen login --token YOUR_API_TOKEN
   terminal-based workflows and automation.
 </Note>
 
+## Full Demo
+
+<iframe
+  className="w-full aspect-video rounded-xl"
+  src="https://youtube.com/embed/sQ2XOonma0w"
+  title="YouTube video player"
+  frameBorder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowFullScreen
+></iframe>
+
 ## Get Started
 
 import {
@@ -70,12 +83,6 @@ import {
   <Card title="Create Account" icon="user-plus" href="https://codegen.sh/login">
     Sign up for a free account and get your API token.
   </Card>
-  <Card title="Join our Slack" icon="slack" href={COMMUNITY_SLACK_URL}>
-    Get help and connect with the Codegen community.
-  </Card>
-  <Card title="Tutorials" icon="diagram-project" href="/tutorials/at-a-glance">
-    Learn how to use Codegen for common code transformation tasks.
-  </Card>
   <Card title="View on GitHub" icon="github" href={CODEGEN_SDK_GITHUB_URL}>
     Star us on GitHub and contribute to the project.
   </Card>
diff --git a/docs/sandboxes/overview.mdx b/docs/sandboxes/overview.mdx
index e8f69e32a..0a6b270e8 100644
--- a/docs/sandboxes/overview.mdx
+++ b/docs/sandboxes/overview.mdx
@@ -4,7 +4,28 @@ sidebarTitle: "Overview"
 icon: "box"
 ---
 
-Codegen agents operate within secure, isolated sandbox environments where they can safely execute code, install dependencies, and run commands without affecting your local machine or production systems.
+Codegen agents operate within secure, isolated sandbox environments where they can safely execute code and run commands without affecting your local machine or production systems.
+
+<Frame>
+  <video
+    controls
+    src="https://res.cloudinary.com/dbikr6pew/video/upload/v1757979569/Sandbox_Configuration_uf9xt6.mp4"
+    className="aspect-[3312/2160]"
+  />
+</Frame>
+
+<Tip>
+  Codegen's sandbox environments are highly configurable and built for
+  enterprise workloads
+</Tip>
+
+<Card
+  title="Configure Sandbox Environments"
+  icon="code"
+  href="https://codegen.com/repos"
+>
+  Select VM resources, install dependencies, securely upload secrets and more.
+</Card>
 
 ## Capabilities
 
@@ -34,4 +55,30 @@ Sandboxes are typically configured per-agent run or defined within your Codegen
   Slack messages or Linear comments, the sandbox state is preserved, allowing
   agents to seamlessly continue their work without losing context or having to
   reinstall dependencies.
-</Note>{" "}
+</Note>
+
+## Sandbox Configuration
+
+<CardGroup cols={2}>
+  <Card title="Setup Commands" icon="terminal" href="/sandboxes/setup-commands">
+    Configure custom setup commands that run when initializing your sandbox
+    environment.
+  </Card>
+  <Card title="Repository Secrets" icon="key" href="/sandboxes/secrets">
+    Manage environment variables and secrets securely injected into your
+    sandbox.
+  </Card>
+  <Card title="Image Snapshots" icon="camera" href="/sandboxes/image-snapshots">
+    Learn how Codegen creates filesystem snapshots for faster initialization.
+  </Card>
+  <Card title="Web Preview" icon="browser" href="/sandboxes/web-preview">
+    Start development servers and view your running applications through
+    Codegen.
+  </Card>
+  <Card title="Base Image" icon="docker" href="/sandboxes/base-image">
+    Explore the comprehensive Docker image that powers Codegen sandboxes.
+  </Card>
+  <Card title="Remote Editor" icon="laptop-code" href="/sandboxes/editor">
+    Access a VSCode editor connected directly to your sandbox environment.
+  </Card>
+</CardGroup>
diff --git a/docs/settings/model-configuration.mdx b/docs/settings/model-configuration.mdx
index 71bb20159..3af818444 100644
--- a/docs/settings/model-configuration.mdx
+++ b/docs/settings/model-configuration.mdx
@@ -6,6 +6,14 @@ icon: "microchip"
 
 Codegen offers flexibility in choosing the Large Language Model (LLM) that powers your agent, allowing you to select from various providers and specific models. You can also configure custom API keys and base URLs if you have specific arrangements or need to use self-hosted models.
 
+<Frame>
+  <video
+    controls
+    src="https://res.cloudinary.com/dbikr6pew/video/upload/v1757976620/Model_Choice_ogcic1.mp4"
+    className="aspect-[3324/2160]"
+  />
+</Frame>
+
 <Card
   title="Configure Model Settings"
   icon="microchip"
@@ -19,7 +27,14 @@ Codegen offers flexibility in choosing the Large Language Model (LLM) that power
 
 LLM Configuration settings are applied globally for your entire organization. You can access and modify these settings by navigating to:
 
-[**codegen.com/settings/model**](https://codegen.com/settings/model)
+<Card
+  title="Configure Model Settings"
+  icon="microchip"
+  href="https://codegen.com/settings/model"
+>
+  Choose your LLM provider, select models, and configure custom API keys for
+  your organization.
+</Card>
 
 This central location ensures that all agents operating under your organization adhere to the selected LLM provider and model, unless specific per-repository or per-agent overrides are explicitly configured (if supported by your plan).
 
diff --git a/docs/settings/repo-rules.mdx b/docs/settings/repo-rules.mdx
index 9c3b81f4b..b0dbc9831 100644
--- a/docs/settings/repo-rules.mdx
+++ b/docs/settings/repo-rules.mdx
@@ -6,6 +6,14 @@ icon: "shield-check"
 
 Agent rules are text prompts that provide instructions to AI agents about coding standards, conventions, and preferences. These text-based rules are automatically injected into the agent's context during each task.
 
+<Frame>
+  <video
+    controls
+    src="https://res.cloudinary.com/dbikr6pew/video/upload/v1757977539/Rules_evkkhx.mp4"
+    className="aspect-[3356/2160]"
+  />
+</Frame>
+
 ## How Agent Rules Work
 
 When an agent starts working, it receives all applicable rules as text prompts in its context:

From 6895a4ccf0539daa72fd8705f2ae539f1d5d6398 Mon Sep 17 00:00:00 2001
From: jayhack <jayhack.0@gmail.com>
Date: Mon, 15 Sep 2025 17:09:39 -0700
Subject: [PATCH 2/2] .

---
 docs/capabilities/pr-review.mdx | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/capabilities/pr-review.mdx b/docs/capabilities/pr-review.mdx
index 4772024f7..fd387bf60 100644
--- a/docs/capabilities/pr-review.mdx
+++ b/docs/capabilities/pr-review.mdx
@@ -1,14 +1,22 @@
 ---
 title: "PR Review Agent"
 sidebarTitle: "PR Review"
-icon: "eye"
+icon: "microscope"
 ---
 
 Codegen provides a configurable AI code review feature similar to CodeRabbit, Graphite, or Greptile as a first-class feature.
 
+<Frame>
+  <video
+    controls
+    src="https://res.cloudinary.com/dbikr6pew/video/upload/v1757981307/Reviews_lufat8.mp4"
+    className="aspect-[3584/2160]"
+  />
+</Frame>
+
 <Card
   title="Configure PR Reviews"
-  icon="eye"
+  icon="microscope"
   href="https://codegen.com/settings/review"
 >
   Set up PR review at the organization level, then customize per repository.