.

Author: jayhack

docs/capabilities/checks-autofixer.mdx

@@ -6,6 +6,12 @@ icon: "bell"
 
 When GitHub checks fail on a Codegen PR, Codegen agents will automatically "wake up", analyze the failure, and push fix commit.
 
+<video
+  controls
+  src="https://res.cloudinary.com/dbikr6pew/video/upload/v1757875834/4-fixing-checks_aagrki.mp4"
+  className="w-full aspect-[3456/2160] rounded-sm"
+/>
+
 This intelligent system monitors CI status and proactively resolves issues without manual intervention.
 
 <Card

docs/docs.json

@@ -17,8 +17,6 @@
             "group": "Overview",
             "pages": [
               "introduction/overview",
-              "introduction/api",
-              "introduction/cli",
               "introduction/prompting",
               "introduction/community",
               "introduction/about",
@@ -29,10 +27,20 @@
             "group": "Capabilities",
             "pages": [
               "capabilities/capabilities",
+              "introduction/api",
+              "introduction/cli",
               "capabilities/checks-autofixer",
               "capabilities/pr-review"
             ]
           },
+          {
+            "group": "Settings",
+            "pages": [
+              "settings/settings",
+              "settings/repo-rules",
+              "settings/model-configuration"
+            ]
+          },
           {
             "group": "Integrations",
             "pages": [
@@ -62,10 +70,6 @@
               "sandboxes/editor",
               "sandboxes/web-preview"
             ]
-          },
-          {
-            "group": "Settings",
-            "pages": ["settings/repo-rules", "settings/model-configuration"]
           }
         ]
       },

docs/integrations/integrations.mdx

@@ -4,7 +4,15 @@ sidebarTitle: "Overview"
 icon: "plug"
 ---
 
-Codegen integrates with your entire development stack to provide seamless AI-powered assistance across all your tools and workflows. Connect your favorite platforms to enable agents that understand your context and can work across multiple systems.
+Frontier agents can work effectively with hundreds of "tools", enabling them to work seamlessly across your existing development stack.
+
+<video
+  controls
+  src="https://res.cloudinary.com/dbikr6pew/video/upload/v1757885715/5-integrations_lxxt3i.mp4"
+  className="w-full aspect-[3456/2160] rounded-sm"
+/>
+
+Connect your favorite platforms to enable agents that understand your context and can work across multiple systems.
 
 ## Core Development
 

docs/settings/settings.mdx

@@ -0,0 +1,51 @@
+---
+title: "Settings"
+sidebarTitle: "Overview"
+icon: "gear"
+---
+
+Configure Codegen to work perfectly with your development workflow. Customize agent behavior, model selection, and repository-specific rules to optimize performance across your entire organization.
+
+## Repository Configuration
+
+<CardGroup cols={2}>
+  <Card
+    title="Repository Rules"
+    icon="shield-check"
+    href="/settings/repo-rules"
+  >
+    Set repository-specific rules and coding standards that agents automatically
+    follow when working on your codebase.
+  </Card>
+</CardGroup>
+
+## Global Configuration
+
+<CardGroup cols={2}>
+  <Card
+    title="Model Configuration"
+    icon="brain-circuit"
+    href="/settings/model-configuration"
+  >
+    Choose your preferred LLM provider and model, configure custom API keys, and
+    optimize performance settings.
+  </Card>
+</CardGroup>
+
+## Getting Started
+
+Settings are organized into repository-level and organization-level configurations:
+
+- **Repository Rules** apply to specific repositories and help agents understand your coding standards and project-specific requirements
+- **Model Configuration** applies globally to your organization and controls which AI models power your agents
+
+<Tip>
+  Start by configuring repository rules for your most active repositories, then
+  optimize model settings based on your team's performance and cost
+  requirements.
+</Tip>
+
+<Note>
+  Some settings may require specific plan tiers or administrative permissions
+  within your organization.
+</Note>