diff --git a/docs/capabilities/analytics.mdx b/docs/capabilities/analytics.mdx
new file mode 100644
index 000000000..31c7355a9
--- /dev/null
+++ b/docs/capabilities/analytics.mdx
@@ -0,0 +1,75 @@
+---
+title: "Agent Analytics"
+sidebarTitle: "Analytics"
+icon: "chart-line"
+---
+
+Get comprehensive insights into your agent activity with detailed analytics on tool usage, costs, performance, and team productivity. Codegen provides fine-grained visibility into how agents are working across your organization.
+
+## Key Metrics
+
+Track the metrics that matter most for your development workflow:
+
+- **Pull Request Analytics** - Monitor code merged, review velocity, and contributor activity
+- **Agent Tool Usage** - See which tools agents use most frequently and their success rates
+- **Cost Analysis** - Track spending across different models, agents, and time periods
+- **Performance Insights** - Analyze agent response times and task completion rates
+- **Team Activity** - Understand how different team members interact with agents
+
+## Features
+
+### Pull Request Tracking
+
+- **Merge velocity** - Track how quickly PRs are created and merged
+- **Author activity** - See contributor patterns and productivity trends
+- **Status monitoring** - Monitor PR states and resolution times
+
+### Detailed Filtering
+
+- **Date range selection** - Analyze data over custom time periods
+- **User-specific views** - Filter by individual team members
+- **Status filtering** - Focus on specific PR states or outcomes
+- **Interactive charts** - Explore data with dynamic visualizations
+
+### Real-time Insights
+
+- **Live dashboards** - Get up-to-date metrics on agent activity
+- **Trend analysis** - Identify patterns in agent usage and effectiveness
+- **Cost optimization** - Make informed decisions about model selection and usage
+
+## Access Analytics
+
+View your organization's analytics dashboard to get started:
+
+
+ Access detailed analytics on agent performance, costs, and team productivity.
+
+
+## Use Cases
+
+**Performance Optimization**
+
+- Identify which agents and tools provide the best ROI
+- Optimize model selection based on cost and performance data
+- Track improvement in development velocity over time
+
+**Team Insights**
+
+- Understand how different team members leverage AI assistance
+- Identify opportunities for increased agent adoption
+- Monitor the impact of agents on overall productivity
+
+**Cost Management**
+
+- Track spending across different LLM providers and models
+- Identify high-cost operations and optimize usage patterns
+- Budget and forecast AI assistance costs
+
+
+ Use analytics to continuously optimize your agent workflows and demonstrate
+ the value of AI assistance to your organization.
+
diff --git a/docs/capabilities/checks-autofixer.mdx b/docs/capabilities/checks-autofixer.mdx
new file mode 100644
index 000000000..3648e6be3
--- /dev/null
+++ b/docs/capabilities/checks-autofixer.mdx
@@ -0,0 +1,115 @@
+---
+title: "Check Suite Auto-fixer"
+sidebarTitle: "Checks Auto-fixer"
+icon: "bell"
+---
+
+When GitHub checks fail on a Codegen PR, Codegen agents will automatically "wake up", analyze the failure, and push fix commit.
+
+
+
+This intelligent system monitors CI status and proactively resolves issues without manual intervention.
+
+
+ Configure globally at the organization level or customize settings per
+ repository. Enterprise plans can adjust retry limits for optimal performance.
+
+
+
+ Codegen will try to fix broken checks 3 times before "tapping out" by default.
+ Enterprise customers can customize the retry count per check or per
+ repository.
+
+
+## How Checks Auto-Fixer Works
+
+Codegen continuously monitors your pull requests and automatically responds to check failures:
+
+- **Automatic Detection:** Monitors GitHub check runs and CI status in real-time
+- **Intelligent Analysis:** Analyzes build logs, test failures, and error messages to understand root causes
+- **Targeted Fixes:** Generates specific code changes to resolve the identified issues
+- **Persistent Retry:** Will attempt to fix issues up to 3 times per PR
+
+## What Triggers Auto-Fixing
+
+Check auto-fixing activates when:
+
+- **CI Checks Fail:** Any GitHub check run reports a failure status
+- **Build Errors:** Compilation, linting, or build process failures
+- **Test Failures:** Unit tests, integration tests, or automated test suites fail
+- **Code Quality Issues:** Static analysis tools report violations or warnings
+
+## The Auto-Fix Process
+
+When Codegen auto-fixes a failing PR, it follows this process:
+
+1. **Detect Failure:** Monitor check status and identify when builds break
+2. **Analyze Logs:** Grep through CI logs to understand specific failure points
+3. **Generate Solution:** Create targeted code changes to resolve identified issues
+4. **Apply Fix:** Automatically commit fixes to the same PR branch
+5. **Re-validate:** Monitor the new check run to ensure the fix was successful
+
+## Retry Logic
+
+Codegen implements intelligent retry behavior:
+
+- **Default: 3 attempts** per PR to resolve failing checks
+- **Enterprise customization** - Enterprise customers can configure retry limits:
+ - Set global defaults at the organization level
+ - Override per repository in repository settings
+ - Customize retry counts per individual check type
+- **Progressive analysis** - each retry incorporates learnings from previous attempts
+- **Failure escalation** - when retry limit is reached, the issue is flagged for human review
+
+## Configuration Options
+
+The Checks Auto-Fixer can be configured at multiple levels:
+
+### Organization Level
+
+- **Global settings** - Configure default behavior for all repositories
+- **Available to all plans** - Enable/disable the feature organization-wide
+- **Access via** - Organization Settings → Checks Auto-Fixer
+
+### Repository Level
+
+- **Per-repo overrides** - Customize settings for specific repositories
+- **Individual check control** - Enable/disable monitoring per check type
+- **Custom instructions** - Provide specific guidance for handling each check
+- **Access via** - Repository Settings → Checks Auto-Fixer
+
+### Enterprise Features
+
+- **Custom retry limits** - Set retry counts globally, per repository, or per check type
+- **Advanced monitoring** - Granular control over which checks to monitor
+- **Priority handling** - Configure high-priority checks for immediate processing
+
+## GitHub Integration
+
+The auto-fix system integrates deeply with GitHub:
+
+- **Check Run Annotations:** Creates detailed feedback with line-specific suggestions
+- **PR Comments:** Adds contextual suggestions and explanations
+- **Auto-Fix Actions:** Provides one-click fix buttons in the GitHub UI
+- **Status Updates:** Real-time updates on fix progress and results
+
+
+ Checks Auto-Fixer only activates for repositories where Codegen has write
+ access and the feature is enabled. It respects your repository permissions and
+ team workflows.
+
+
+## Benefits
+
+- **Reduced Context Switching:** No need to manually investigate and fix CI failures
+- **Faster Iteration:** PRs get fixed automatically, keeping development velocity high
+- **Learning from Failures:** Each fix improves Codegen's understanding of your codebase
+- **24/7 Monitoring:** Works around the clock to keep your PRs in good shape
diff --git a/docs/capabilities/pr-review.mdx b/docs/capabilities/pr-review.mdx
new file mode 100644
index 000000000..4772024f7
--- /dev/null
+++ b/docs/capabilities/pr-review.mdx
@@ -0,0 +1,53 @@
+---
+title: "PR Review Agent"
+sidebarTitle: "PR Review"
+icon: "eye"
+---
+
+Codegen provides a configurable AI code review feature similar to CodeRabbit, Graphite, or Greptile as a first-class feature.
+
+
+ Set up PR review at the organization level, then customize per repository.
+
+
+## How It Works
+
+When you open a PR or push new commits, Codegen agents analyze the changes and provide:
+
+- **Inline comments** on specific lines with actionable feedback
+- **Security scanning** for vulnerabilities and unsafe patterns
+- **Code quality** suggestions for maintainability and best practices
+- **Architectural feedback** on design patterns and structure
+
+## Configuration
+
+Configure PR reviews at two levels:
+
+### Organization Settings
+
+Set global defaults and organization-wide review rules at [Organization Settings → PR Review](https://codegen.com/settings/review).
+
+### Repository Settings
+
+Override settings and add repository-specific rules at **Repository Settings → Review**.
+
+Repository rules are combined with organization rules for comprehensive coverage. You can:
+
+- Enable/disable PR reviews for the repository
+- Add custom review guidelines specific to the codebase
+- Define language-specific requirements
+- Set repository-specific coding standards
+
+
+ Start with organization-level settings, then customize individual repositories
+ as needed.
+
+
+
+ PR reviews require read access to your repository. Enable the feature at both
+ organization and repository levels to activate reviews.
+
diff --git a/docs/capabilities/wake-up.mdx b/docs/capabilities/wake-up.mdx
deleted file mode 100644
index a542d7594..000000000
--- a/docs/capabilities/wake-up.mdx
+++ /dev/null
@@ -1,67 +0,0 @@
----
-title: "Wake Up & Auto-Fix"
-sidebarTitle: "Wake Up"
-icon: "bell"
----
-
-When your GitHub checks fail, Codegen automatically wakes up to analyze the failures and fix your PR. This intelligent system monitors CI status and proactively resolves issues without manual intervention.
-
-Codegen will try to fix broken checks 3x before "tapping out"
-
-## How Wake Up Works
-
-Codegen continuously monitors your pull requests and automatically responds to check failures:
-
-- **Automatic Detection:** Monitors GitHub check runs and CI status in real-time
-- **Intelligent Analysis:** Analyzes build logs, test failures, and error messages to understand root causes
-- **Targeted Fixes:** Generates specific code changes to resolve the identified issues
-- **Persistent Retry:** Will attempt to fix issues up to 3 times per PR
-
-## What Triggers Wake Up
-
-Wake up activates when:
-
-- **CI Checks Fail:** Any GitHub check run reports a failure status
-- **Build Errors:** Compilation, linting, or build process failures
-- **Test Failures:** Unit tests, integration tests, or automated test suites fail
-- **Code Quality Issues:** Static analysis tools report violations or warnings
-
-## The Auto-Fix Process
-
-When Codegen wakes up to fix a failing PR, it follows this process:
-
-1. **Detect Failure:** Monitor check status and identify when builds break
-2. **Analyze Logs:** Grep through CI logs to understand specific failure points
-3. **Generate Solution:** Create targeted code changes to resolve identified issues
-4. **Apply Fix:** Automatically commit fixes to the same PR branch
-5. **Re-validate:** Monitor the new check run to ensure the fix was successful
-
-## Retry Logic
-
-Codegen implements intelligent retry behavior:
-
-- **Up to 3 attempts** per PR to resolve failing checks
-- **Progressive analysis** - each retry incorporates learnings from previous attempts
-- **Failure escalation** - if 3 attempts fail, the issue is flagged for human review
-
-## GitHub Integration
-
-The wake-up system integrates deeply with GitHub:
-
-- **Check Run Annotations:** Creates detailed feedback with line-specific suggestions
-- **PR Comments:** Adds contextual suggestions and explanations
-- **Auto-Fix Actions:** Provides one-click fix buttons in the GitHub UI
-- **Status Updates:** Real-time updates on fix progress and results
-
-
- Wake up only activates for repositories where Codegen has write access and the
- feature is enabled. It respects your repository permissions and team
- workflows.
-
-
-## Benefits
-
-- **Reduced Context Switching:** No need to manually investigate and fix CI failures
-- **Faster Iteration:** PRs get fixed automatically, keeping development velocity high
-- **Learning from Failures:** Each fix improves Codegen's understanding of your codebase
-- **24/7 Monitoring:** Works around the clock to keep your PRs in good shape
diff --git a/docs/docs.json b/docs/docs.json
index 4c496eda1..290006924 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -17,8 +17,6 @@
"group": "Overview",
"pages": [
"introduction/overview",
- "introduction/api",
- "introduction/cli",
"introduction/prompting",
"introduction/community",
"introduction/about",
@@ -27,23 +25,42 @@
},
{
"group": "Capabilities",
- "pages": ["capabilities/capabilities", "capabilities/wake-up"]
+ "pages": [
+ "capabilities/capabilities",
+ "capabilities/checks-autofixer",
+ "capabilities/pr-review",
+ "capabilities/analytics",
+ "introduction/cli",
+ "introduction/sdk"
+ ]
+ },
+ {
+ "group": "Settings",
+ "pages": [
+ "settings/settings",
+ "settings/repo-rules",
+ "settings/model-configuration",
+ "settings/agent-behavior",
+ "settings/agent-permissions"
+ ]
},
{
"group": "Integrations",
"pages": [
+ "integrations/integrations",
"integrations/github",
"integrations/slack",
"integrations/linear",
"integrations/notion",
"integrations/figma",
+ "integrations/jira",
+ "integrations/clickup",
+ "integrations/monday",
+ "integrations/sentry",
"integrations/circleci",
"integrations/web-search",
"integrations/postgres",
- {
- "group": "integrations/mcp",
- "name": "Remote MCP Server"
- }
+ "integrations/mcp-servers"
]
},
{
@@ -56,10 +73,6 @@
"sandboxes/editor",
"sandboxes/web-preview"
]
- },
- {
- "group": "Settings",
- "pages": ["settings/repo-rules", "settings/model-configuration"]
}
]
},
diff --git a/docs/integrations/clickup.mdx b/docs/integrations/clickup.mdx
new file mode 100644
index 000000000..85c69d2e9
--- /dev/null
+++ b/docs/integrations/clickup.mdx
@@ -0,0 +1,74 @@
+---
+title: "ClickUp Integration"
+sidebarTitle: "ClickUp"
+icon: "feather"
+---
+
+import { COMMUNITY_SLACK_URL } from "/snippets/links.mdx";
+
+Integrate Codegen with your ClickUp workspace to enable AI-powered task creation and project management. Codegen can create tasks, update statuses, manage dependencies, and coordinate development workflows across your team.
+
+## Installation
+
+Connect your ClickUp workspace to Codegen to enable agent interactions.
+
+
+ Authorize Codegen to access your ClickUp workspace and project data.
+
+
+
+ The ClickUp integration is currently in beta. Please reach out in the{" "}
+ community to have it enabled for your
+ Codegen account.
+
+
+## Capabilities
+
+The ClickUp integration provides comprehensive task management capabilities:
+
+- **Create tasks in your workspace** - Generate new tasks automatically based on development needs and project requirements
+- **Update existing tasks and status** - Modify task details, progress, and completion status as work advances
+- **Read workspace structure and data** - Access project hierarchies, spaces, folders, and lists to understand organization
+- **Add comments to tasks and discussions** - Provide updates, ask questions, and facilitate team collaboration
+- **Assign tasks to team members** - Route work to appropriate developers and coordinate team workload
+- **Access custom fields and properties** - Work with specialized data fields and project-specific information
+- **Read and update task dependencies** - Manage task relationships and project workflow dependencies
+- **View workspace members and teams** - Access team structure for proper task assignment and collaboration
+
+## Permissions
+
+The Codegen ClickUp integration requires the following permissions:
+
+- **Create tasks in your workspace** - Generate new tasks and to-do items as needed
+- **Update existing tasks and status** - Modify task progress, completion status, and details
+- **Read workspace structure and data** - Access project organization, spaces, and folder structures
+- **Add comments to tasks and discussions** - Provide updates and facilitate collaboration
+- **Assign tasks to team members** - Route work to appropriate team members
+- **Access custom fields and properties** - Work with specialized project data and configurations
+- **Read and update task dependencies** - Manage workflow relationships between tasks
+- **View workspace members and teams** - Access team information for proper task management
+
+## How Agents Use ClickUp
+
+Agents leverage the ClickUp integration to:
+
+- **Track Work:** Automatically update the status of tasks they are working on
+- **Create Tasks:** Generate new tasks for follow-up work, bugs discovered, or sub-tasks
+- **Link Development:** Connect implemented changes and GitHub PRs directly to relevant ClickUp tasks
+- **Provide Updates:** Add comments to tasks with progress reports, results, or questions
+- **Manage Dependencies:** Update task relationships as development work progresses
+- **Coordinate Teams:** Assign and reassign tasks based on workload and expertise
+
+
+ **Data Access Notice:** Workspace content can be surfaced in agent runs by any
+ of your Codegen account members. Do not connect sensitive workspaces.
+
+
+
+ The ClickUp integration requires feature flag access. Contact your team
+ administrator to enable this integration.
+
diff --git a/docs/integrations/figma.mdx b/docs/integrations/figma.mdx
index 38f355c7d..12dac82a3 100644
--- a/docs/integrations/figma.mdx
+++ b/docs/integrations/figma.mdx
@@ -6,6 +6,18 @@ icon: "figma"
AI is one of the most valuable collaborators for front-end modifications, UI updates, messaging, and crafting the aesthetic of what you're building. Codegen can now do serious work on both implementation and contributing to your design documentation, bridging the gap between design and code seamlessly.
+## Installation
+
+Connect your Figma account to Codegen to enable design-to-code workflows.
+
+
+ Authorize Codegen to access your Figma files and design resources.
+
+
## Capabilities
The Figma integration enables seamless design-to-code workflows:
@@ -37,19 +49,7 @@ Agents leverage the Figma integration to:
- **Extract Assets:** Pull icons, images, and other visual assets needed for implementation
- **Maintain Design Systems:** Ensure code implementation follows design system guidelines and tokens
-## Installation
-
-Connect your Figma account to Codegen to enable design-to-code workflows.
-
-
- Authorize Codegen to access your Figma files and design resources.
-
-
The Figma integration requires feature flag access. Contact your team
administrator to enable this integration.
-{" "}
+
diff --git a/docs/integrations/github.mdx b/docs/integrations/github.mdx
index 03c14e23b..d8a7aeba7 100644
--- a/docs/integrations/github.mdx
+++ b/docs/integrations/github.mdx
@@ -6,6 +6,18 @@ icon: "github"
GitHub is how Codegen accesses your repository contents and performs all git interactions. Codegen can create PRs from requests or issues, help resolve merge conflicts, conduct code reviews, search through your codebase, and handle the full spectrum of agentic coding workflows—everything flows through GitHub.
+## Installation
+
+Authorize Codegen to access your GitHub organizations and repositories.
+
+
+ Click here to install the Codegen GitHub App and grant necessary permissions.
+
+
## Capabilities
The GitHub integration provides comprehensive development workflow capabilities:
@@ -37,22 +49,10 @@ Agents leverage the GitHub integration to:
- **Request Reviews:** Open pull requests and automatically request reviews from specified team members.
- **Report Progress:** Comment on related issues or PRs with updates, results, or requests for clarification.
-## Installation
-
-Authorize Codegen to access your GitHub organizations and repositories.
-
You can manage repository access granularly through the GitHub App settings.
-
- Click here to install the Codegen GitHub App and grant necessary permissions.
-
-
Ensure the agent has access to the specific repositories it needs to work on.
diff --git a/docs/integrations/integrations.mdx b/docs/integrations/integrations.mdx
new file mode 100644
index 000000000..0b27bbdb2
--- /dev/null
+++ b/docs/integrations/integrations.mdx
@@ -0,0 +1,111 @@
+---
+title: "Integrations"
+sidebarTitle: "Overview"
+icon: "plug"
+---
+
+Frontier agents can work effectively with hundreds of "tools", enabling them to work seamlessly across your existing development stack.
+
+
+
+Connect your favorite platforms to enable agents that understand your context and can work across multiple systems.
+
+## Core Development
+
+
+
+ Access repositories, create PRs, conduct code reviews, and manage the full development workflow through GitHub.
+
+
+
+ Chat with Codegen directly in channels, get real-time notifications, and collaborate seamlessly within your workspace.
+
+
+
+## Project Management
+
+
+
+ Track progress, create issues, and orchestrate teams of humans and agents working together on complex tasks.
+
+
+{" "}
+
+
+ Manage issues, update project status, and coordinate development workflows
+ across your team.
+
+
+{" "}
+
+
+ Create tasks, manage dependencies, and coordinate development workflows with
+ AI-powered project management.
+
+
+
+ Automate project management with intelligent task creation, status updates, and team coordination.
+
+
+
+## Design & Documentation
+
+
+
+ Convert designs to code, extract assets, and maintain design systems with seamless design-to-code workflows.
+
+
+
+ Access your knowledge base, analyze PRDs and specs, and bridge the gap between planning documents and code.
+
+
+
+## DevOps & Monitoring
+
+
+
+ Monitor CI checks, analyze build logs, and automatically fix failing tests and builds.
+
+
+
+ Analyze errors with automated root cause analysis and intelligent insights for faster issue resolution.
+
+
+
+## Data & Search
+
+
+
+ Query databases, analyze schemas, and generate data-driven reports with secure database access.
+
+
+
+ Access real-time information from the internet with intelligent search and content analysis capabilities.
+
+
+
+## Extensibility
+
+
+
+ Connect custom tools and services to extend agent capabilities through Model Context Protocol servers.
+
+
+
+ Access Codegen APIs through a hosted MCP server for seamless AI agent integration.
+
+
+
+## Getting Started
+
+Most integrations require authentication and configuration through the [Codegen dashboard](https://codegen.com/integrations). Each integration provides specific capabilities that agents can leverage to assist with your development workflow.
+
+
+ Start with GitHub and Slack for the most comprehensive development experience,
+ then add project management tools like Linear or Jira based on your team's
+ workflow.
+
diff --git a/docs/integrations/jira.mdx b/docs/integrations/jira.mdx
index 83ed24f7c..390fd98d7 100644
--- a/docs/integrations/jira.mdx
+++ b/docs/integrations/jira.mdx
@@ -10,8 +10,22 @@ Integrate Codegen with your Jira workspace to allow agents to interact with issu
+## Installation
+
+Connect your Jira workspace to Codegen to enable agent interactions.
+
+
+ Authorize Codegen to access your Jira workspace and project data.
+
+
- The Jira integration is currently in beta. Please reach out in the community to have it enabled for your Codegen account.
+ The Jira integration is currently in beta. Please reach out in the{" "}
+ community to have it enabled for your
+ Codegen account.
## Step-by-Step Setup Guide
@@ -19,32 +33,40 @@ Integrate Codegen with your Jira workspace to allow agents to interact with issu
Follow these steps to successfully connect Codegen to your Jira workspace:
### 1. Enable User-Installed Apps in Jira
+
- In your Jira workspace, ensure that **user-installed apps** are enabled.
- Make sure the setting to allow user-installed apps is enabled. This is required for the Codegen integration to work properly.
- If you don't have admin access to enable user-installed apps, contact your Jira administrator to enable this setting before proceeding.
+ If you don't have admin access to enable user-installed apps, contact your
+ Jira administrator to enable this setting before proceeding.
### 2. Create a Dedicated Jira User for Codegen
+
- In your Jira workspace, create a new user account specifically for Codegen.
- **Email:** Use an address with `codegen` in it, like `yourname+codegen@company_domain.com` or `codegen@company_domain.com`.
- **Name:** Set the user's name to **Codegen**. This makes it easy to identify actions performed by Codegen in Jira.
### 3. Authorize Codegen with the New Jira User
+
- Log in to Jira as the new Codegen user.
- Go to [Codegen's Jira Integration page](https://codegen.com/integrations/jira).
- Click **Connect Jira Workspace** and complete the OAuth flow **using the Codegen Jira user** you just created.
- Make sure you are logged in as the Codegen Jira user when authorizing access. This is to ensure Codegen acts on behalf of the new user and not your personal account.
+ Make sure you are logged in as the Codegen Jira user when authorizing access.
+ This is to ensure Codegen acts on behalf of the new user and not your personal
+ account.
### 4. Switch Back to Your Own Jira Account
+
- After connecting, log out of the Codegen Jira user in Jira.
- Log back in with your personal Jira account.
### 5. Use Codegen in Your Workflow
+
- On any Jira ticket, `@mention` the Codegen user (e.g., `@Codegen`) to assign or notify Codegen about the issue.
- Codegen will interact with the ticket, update statuses, add comments, and link PRs as needed.
@@ -63,4 +85,3 @@ Agents use the Jira integration to streamline project management:
- **Link Code:** Connect implemented changes (GitHub PRs) directly to the relevant Jira issue.
- **Provide Updates:** Post comments on issues with progress reports, results, or questions.
- **Create Tasks:** Generate new issues for follow-up work, bugs discovered, or sub-tasks.
-
diff --git a/docs/integrations/linear.mdx b/docs/integrations/linear.mdx
index 01a1ee099..c3fb09d2c 100644
--- a/docs/integrations/linear.mdx
+++ b/docs/integrations/linear.mdx
@@ -1,7 +1,7 @@
---
title: "Linear Integration"
sidebarTitle: "Linear"
-icon: "file-lines"
+icon: "moon"
---
Linear is designed to orchestrate teams of humans and agents working together. It's the most efficient way to track progress and scale teams of agents to tackle large, complex tasks. Codegen can take a first pass at virtually any issue, breaking down work and making meaningful progress before human review. We recommend letting Codegen handle the initial exploration and implementation of most tasks.
@@ -14,7 +14,7 @@ Connect your Linear workspace to Codegen to enable agent interactions.
Authorize Codegen to access your Linear workspace via the API settings.
diff --git a/docs/integrations/mcp-servers.mdx b/docs/integrations/mcp-servers.mdx
new file mode 100644
index 000000000..f6406c7ef
--- /dev/null
+++ b/docs/integrations/mcp-servers.mdx
@@ -0,0 +1,82 @@
+---
+title: "MCP Servers"
+sidebarTitle: "MCP Servers"
+icon: "server"
+---
+
+Connect external tools and services to enhance your AI agent capabilities through Model Context Protocol (MCP) servers. Codegen allows you to connect arbitrary MCP servers that we will run and manage for your agents.
+
+## Installation
+
+Configure MCP servers to extend your agent capabilities with custom tools and services.
+
+
+ Connect custom MCP servers to enhance your agent workflows.
+
+
+## Capabilities
+
+The MCP integration provides comprehensive extensibility for your agents:
+
+- **Connect custom tools and services** - Integrate any MCP-compatible server to extend agent functionality
+- **Extend agent capabilities** - Add specialized tools, APIs, and data sources to your development workflow
+- **Managed execution** - Codegen runs and manages your MCP servers, handling infrastructure and reliability
+- **Secure integration** - Connect external services while maintaining security and access controls
+- **Repository-specific configuration** - Configure different MCP servers for different repositories and projects
+- **Real-time connectivity** - Agents can interact with MCP servers in real-time during task execution
+
+## How It Works
+
+Codegen's MCP server integration allows you to:
+
+1. **Configure MCP Servers** - Add MCP server configurations through the Codegen interface
+2. **Repository Integration** - Associate MCP servers with specific repositories for targeted functionality
+3. **Agent Access** - Agents automatically discover and use available MCP server tools during execution
+4. **Managed Infrastructure** - Codegen handles server deployment, scaling, and maintenance
+
+## Supported MCP Servers
+
+You can connect any MCP-compatible server, including:
+
+- **Database connectors** - Connect to PostgreSQL, MySQL, MongoDB, and other databases
+- **API integrations** - Access REST APIs, GraphQL endpoints, and web services
+- **Development tools** - Integrate with testing frameworks, deployment tools, and CI/CD systems
+- **Custom business logic** - Add company-specific tools and workflows
+- **External services** - Connect to cloud services, monitoring tools, and third-party platforms
+
+## Configuration
+
+MCP servers are configured per repository using a JSON configuration file. The configuration includes:
+
+- **Server details** - URL, authentication, and connection parameters
+- **Tool mapping** - Define which tools are available to agents
+- **Access controls** - Specify permissions and security settings
+- **Environment variables** - Configure server-specific settings and secrets
+
+## Permissions
+
+The Codegen MCP integration requires the following permissions:
+
+- **Connect to external MCP servers** - Establish connections to your configured servers
+- **Execute custom tool functions** - Run tools and commands provided by MCP servers
+- **Access server-provided resources** - Read and write data through MCP server interfaces
+- **Manage server configurations** - Update and modify MCP server settings
+
+## How Agents Use MCP Servers
+
+Agents leverage MCP servers to:
+
+- **Extend Functionality:** Access tools and capabilities beyond built-in agent features
+- **Connect External Systems:** Interact with databases, APIs, and services specific to your workflow
+- **Custom Workflows:** Execute company-specific processes and business logic
+- **Data Integration:** Access and manipulate data from various sources and formats
+- **Specialized Tools:** Use domain-specific tools for testing, deployment, monitoring, and more
+
+
+ MCP server integration allows for powerful extensibility but requires careful
+ configuration to ensure security and proper access controls.
+
diff --git a/docs/integrations/mcp.mdx b/docs/integrations/mcp.mdx
index 93e850fae..b3e79b6b8 100644
--- a/docs/integrations/mcp.mdx
+++ b/docs/integrations/mcp.mdx
@@ -30,6 +30,7 @@ claude mcp add --transport http codegen-tools https://mcp.codegen.com/mcp/ \
```
Replace:
+
- `` with your Codegen API key
- `` with your organization ID (optional, automatically added when using `codegen claude`)
- `` with your repository ID (optional, automatically added when using `codegen claude`)
@@ -55,6 +56,7 @@ Add the following configuration to your settings:
```
Replace:
+
- `` with your Codegen API key
- `` with your organization ID (optional)
- `` with your repository ID (optional)
@@ -81,6 +83,7 @@ If you're using VSCode with an MCP extension, add this to your settings.json:
```
Replace:
+
- `` with your Codegen API key
- `` with your organization ID (optional)
- `` with your repository ID (optional)
diff --git a/docs/integrations/monday.mdx b/docs/integrations/monday.mdx
new file mode 100644
index 000000000..4a778483c
--- /dev/null
+++ b/docs/integrations/monday.mdx
@@ -0,0 +1,56 @@
+---
+title: "Monday.com Integration"
+sidebarTitle: "Monday.com"
+icon: "fan"
+---
+
+Integrate Codegen with your Monday.com workspace to enable AI-powered project management with intelligent task automation. Codegen can create and update items, manage boards, and keep your team synchronized across development workflows.
+
+## Installation
+
+Connect your Monday.com workspace to Codegen to enable agent interactions.
+
+
+ Authorize Codegen to access your Monday.com workspace and project boards.
+
+
+## Capabilities
+
+The Monday.com integration provides comprehensive project management capabilities:
+
+- **Create and update items** - Generate new tasks and update existing ones based on development needs
+- **Read and update items** - Access and modify task details, status, and progress information
+- **Manage boards and columns** - Organize work across different project boards and customize workflows
+- **Team coordination** - Assign tasks to team members and manage workload distribution
+- **Status synchronization** - Keep project status current as work progresses through different stages
+- **Automated reporting** - Generate progress reports and project insights based on development activity
+
+## Permissions
+
+The Codegen Monday.com integration requires the following permissions:
+
+- **Read and update items** - Access and modify task details and progress information
+- **Read and update boards** - Manage project boards and organizational structure
+- **Read and update columns** - Customize workflows and data fields
+- **Read and update groups** - Organize tasks into logical groupings
+- **Read and update users** - Access team member information for task assignment
+- **Read and update workspaces** - Manage workspace-level settings and permissions
+
+## How Agents Use Monday.com
+
+Agents leverage the Monday.com integration to:
+
+- **Track Work:** Automatically update the status of items they are working on
+- **Create Tasks:** Generate new items for follow-up work, bugs discovered, or sub-tasks
+- **Provide Updates:** Add updates to items with progress reports, results, or questions
+- **Link Development:** Connect implemented changes and code work directly to relevant Monday.com items
+- **Manage Workflows:** Update item status as work progresses through different development stages
+
+
+ The Monday.com integration requires feature flag access. Contact your team
+ administrator to enable this integration.
+
diff --git a/docs/integrations/notion.mdx b/docs/integrations/notion.mdx
index bcb53ad89..4de002e9f 100644
--- a/docs/integrations/notion.mdx
+++ b/docs/integrations/notion.mdx
@@ -1,11 +1,23 @@
---
title: "Notion Integration"
sidebarTitle: "Notion"
-icon: "books"
+icon: "book"
---
Notion is your team's knowledge base, and now Codegen can tap into it too. Share PRDs, specs, and documentation with Codegen for technical feedback and implementation. A common workflow: pass a PRD to Codegen and it will provide technical insights, comment directly on the document, and then go implement the features described.
+## Installation
+
+Connect your Notion workspace to Codegen to enable agent interactions with your knowledge base.
+
+
+ Authorize Codegen to access your Notion workspace and documentation.
+
+
## Capabilities
The Notion integration enables seamless access to your team's knowledge base:
@@ -36,19 +48,7 @@ Agents leverage the Notion integration to:
- **Update Documentation:** Keep project documentation current as development progresses
- **Bridge Planning and Code:** Connect high-level planning documents with actual code implementation
-## Installation
-
-Connect your Notion workspace to Codegen to enable agent interactions with your knowledge base.
-
-
- Authorize Codegen to access your Notion workspace and documentation.
-
-
The Notion integration requires feature flag access. Contact your team
administrator to enable this integration.
-{" "}
+
diff --git a/docs/integrations/sentry.mdx b/docs/integrations/sentry.mdx
new file mode 100644
index 000000000..9028b931c
--- /dev/null
+++ b/docs/integrations/sentry.mdx
@@ -0,0 +1,63 @@
+---
+title: "Sentry Integration"
+sidebarTitle: "Sentry"
+icon: "triangle"
+---
+
+import { COMMUNITY_SLACK_URL } from "/snippets/links.mdx";
+
+Integrate Codegen with your Sentry workspace to enable AI-powered error tracking with automated root cause analysis. Codegen can analyze errors, investigate issues, and provide intelligent insights to help resolve production problems faster.
+
+## Installation
+
+Connect your Sentry organization to Codegen to enable agent interactions with error tracking data.
+
+
+ Authorize Codegen to access your Sentry organization and error data.
+
+
+
+ The Sentry integration is currently in beta. Please reach out in the{" "}
+ community to have it enabled for your
+ Codegen account.
+
+
+## Capabilities
+
+The Sentry integration provides comprehensive error tracking and analysis capabilities:
+
+- **Automated root cause analysis** - Analyze error patterns and stack traces to identify underlying issues
+- **Error investigation** - Deep dive into error contexts, user impact, and related code changes
+- **Issue prioritization** - Help identify critical errors that need immediate attention
+- **Performance monitoring** - Analyze performance issues and bottlenecks in your applications
+- **Release tracking** - Connect errors to specific deployments and code changes
+- **Team coordination** - Assign issues to appropriate team members based on expertise and ownership
+
+## Permissions
+
+The Codegen Sentry integration requires the following permissions:
+
+- **Read organization information** - Access organization settings and configuration
+- **Read/Write project information** - Access project details and modify project settings
+- **Read/Write team information** - Access team structure and manage team assignments
+- **Read/Write event information** - Analyze error events and update issue status
+
+## How Agents Use Sentry
+
+Agents leverage the Sentry integration to:
+
+- **Analyze Errors:** Examine error patterns, stack traces, and user impact to understand root causes
+- **Investigate Issues:** Deep dive into error contexts, related code changes, and deployment history
+- **Provide Insights:** Generate intelligent analysis and recommendations for error resolution
+- **Track Progress:** Update issue status and resolution progress as fixes are implemented
+- **Link Development:** Connect error fixes to GitHub PRs and code changes
+- **Prioritize Work:** Help identify critical errors that require immediate attention
+
+
+ The Sentry integration requires feature flag access. Contact your team
+ administrator to enable this integration.
+
diff --git a/docs/integrations/slack.mdx b/docs/integrations/slack.mdx
index b62fcdca2..987ebb24c 100644
--- a/docs/integrations/slack.mdx
+++ b/docs/integrations/slack.mdx
@@ -6,7 +6,11 @@ icon: "slack"
Connect Codegen to your Slack workspace to enable seamless communication between agents and your team.
-
+
Slack is the most fluid way to communicate with Codegen. Simply tag @codegen in any channel to collaborate directly and give it tasks that leverage all your other integrations. As an agent, Codegen can seamlessly work across platforms—from GitHub to Linear to your databases—all initiated from Slack. We recommend Slack as the lowest barrier entry point for all users.
@@ -85,15 +89,18 @@ Codegen only responds when tagged or messaged directly. Use these approaches to
The Codegen Slack integration requires the following permissions to function effectively:
### Core Messaging Permissions
+
- **View messages that mention @codegen** - To respond to direct mentions and requests
- **Read message history in public and private channels** - To understand context and conversation flow
- **Read direct messages and group chats** (`mpim:read`) - To enable private conversations with the agent in group DMs and multi-person direct messages
- **Send messages** - To communicate responses and provide updates
### Enhanced Communication Features
+
- **View and react with emojis** - To acknowledge messages and provide feedback through reactions
### User and Workspace Access
+
- **View workspace members and email addresses** (`users:read.email`) - Used to map Slack user accounts to Codegen accounts for proper authentication and permission management. This ensures that when a user interacts with Codegen via Slack, their actions are properly attributed to their Codegen account and repository permissions
- **Access shared files and attachments** - To review and work with shared content like code snippets, images, and documents
- **Access basic channel information** - To operate appropriately within different channel contexts
diff --git a/docs/introduction/api.mdx b/docs/introduction/sdk.mdx
similarity index 97%
rename from docs/introduction/api.mdx
rename to docs/introduction/sdk.mdx
index 27cc8ed7a..2c9f7d0ab 100644
--- a/docs/introduction/api.mdx
+++ b/docs/introduction/sdk.mdx
@@ -1,8 +1,7 @@
---
-title: "Codegen SDK"
-sidebarTitle: "API"
-icon: "bolt"
-iconType: "solid"
+title: "Python SDK"
+sidebarTitle: "Python SDK"
+icon: "python"
---
The [Codegen SDK](https://github.com/codegen-sh/codegen-sdk) enables developers to programmatically interact with [Codegen](https://codegen.com) SWE agents via API.
diff --git a/docs/sandboxes/overview.mdx b/docs/sandboxes/overview.mdx
index 86f57cab2..e8f69e32a 100644
--- a/docs/sandboxes/overview.mdx
+++ b/docs/sandboxes/overview.mdx
@@ -29,5 +29,9 @@ Agents utilize sandboxes for a variety of tasks:
Sandboxes are typically configured per-agent run or defined within your Codegen settings. You often don't need to manage them directly, but advanced configurations might allow specifying Docker images or environment variables.
- Sandboxes maintain file system persistence between agent interactions within the same context. For example, when continuing a conversation across different 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.
+ Sandboxes maintain file system persistence between agent interactions within
+ the same context. For example, when continuing a conversation across different
+ 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.
{" "}
diff --git a/docs/settings/agent-behavior.mdx b/docs/settings/agent-behavior.mdx
new file mode 100644
index 000000000..0d7ff99be
--- /dev/null
+++ b/docs/settings/agent-behavior.mdx
@@ -0,0 +1,94 @@
+---
+title: "Agent Behavior"
+sidebarTitle: "Agent Behavior"
+icon: "robot"
+---
+
+Configure the types of behaviors you'd like the AI agent to exhibit. These settings control how agents interact with users and approach code modifications to ensure they align with your team's workflow preferences.
+
+## Available Behaviors
+
+### Propose Plan
+
+Control whether the codegen agent should propose a detailed implementation plan to the user before executing **all** code modifications, regardless of size or complexity.
+
+**When enabled:**
+
+- Agents will present a structured plan showing each implementation step
+- Users can review the proposed approach before any code changes are made
+- Plans include confidence levels, relevant files, and detailed descriptions
+- Provides transparency into the agent's decision-making process
+
+**When disabled:**
+
+- Agents proceed directly with code modifications
+- Faster execution for straightforward tasks
+- Users can still request plans explicitly when needed
+
+
+ Enable this setting if you prefer to review and approve implementation
+ approaches before code changes are made, especially for critical or complex
+ repositories.
+
+
+### Require Explicit GitHub Mentions
+
+Control whether the codegen agent should only respond to GitHub comments that explicitly mention `@codegen` or `@codegen-sh`.
+
+**When enabled:**
+
+- Agent only responds to comments containing explicit mentions
+- Provides precise control over when agents activate
+- Reduces unwanted agent responses on general discussions
+- Recommended for busy repositories with frequent comments
+
+**When disabled:**
+
+- Agent may respond to relevant comments without explicit mentions
+- More proactive agent engagement
+- Convenient for smaller teams with focused discussions
+
+
+ In busy repositories, disabling explicit mentions may result in agents
+ responding to unintended comments. Consider your team's communication patterns
+ when configuring this setting.
+
+
+## Configuration
+
+These behavior settings are configured at the organization level and apply to all repositories within your organization. Individual repository settings may override some behaviors where supported.
+
+Access your agent behavior settings at:
+
+
+ Customize how agents interact with your team and approach code modifications.
+
+
+## Best Practices
+
+**For New Teams:**
+
+- Start with "Propose Plan" enabled to understand how agents approach problems
+- Use explicit GitHub mentions initially to control agent activation
+- Gradually adjust settings as your team becomes comfortable with agent behavior
+
+**For Experienced Teams:**
+
+- Disable "Propose Plan" for routine tasks to increase velocity
+- Consider allowing non-explicit mentions in trusted repositories
+- Customize settings based on repository criticality and team preferences
+
+**For Large Organizations:**
+
+- Enable explicit mentions to prevent noise in high-traffic repositories
+- Use "Propose Plan" for production or critical infrastructure repositories
+- Consider different settings for different types of repositories
+
+
+ Agent behavior settings help ensure that AI assistance integrates smoothly
+ with your existing development workflows and team communication patterns.
+
diff --git a/docs/settings/agent-permissions.mdx b/docs/settings/agent-permissions.mdx
index c3d7b26da..b42328a57 100644
--- a/docs/settings/agent-permissions.mdx
+++ b/docs/settings/agent-permissions.mdx
@@ -1,76 +1,159 @@
---
title: "Agent Permissions"
sidebarTitle: "Agent Permissions"
-icon: "user-shield"
+icon: "shield-check"
---
-Agent Permissions allow you to configure what actions the AI agent is allowed to perform across your organization. These settings provide fine-grained control over the agent's capabilities, ensuring it operates within your team's preferred workflows and security boundaries.
+Configure what actions the AI agent is allowed to perform across your organization. These permission settings provide fine-grained control over agent capabilities to ensure they operate within your security and workflow requirements.
-## Accessing Agent Permissions
+## Available Permissions
-Agent Permission settings are applied globally for your entire organization. You can access and modify these settings by navigating to:
+### Enable PR Creation
-[**codegen.com/settings/permissions**](https://codegen.com/settings/permissions)
+Control whether the codegen agent is able to create pull requests in your repositories in response to user requests.
-
- 
-
+**When enabled:**
-## Available Permission Settings
+- Agents can create new pull requests with code changes
+- PRs include detailed descriptions and context
+- Automatic linking to related issues and discussions
+- Supports your standard code review workflow
-### Enable PR Creation
+**When disabled:**
+
+- Agents can still analyze code and provide suggestions
+- Code changes are proposed but not committed
+- Manual PR creation required for implementing changes
+- Useful for read-only or advisory agent roles
-**Control whether the codegen agent is able to create pull requests in your repositories in response to user requests.**
+### Enable Rules Detection
-When enabled, the agent can automatically create pull requests when implementing features, fixing bugs, or making other code changes. When disabled, the agent will make changes locally but won't create PRs, requiring manual PR creation.
+Allow the agent to automatically detect and apply rules from various rule files in your repositories.
-- **Default**: Enabled
-- **Use Case**: Disable if you prefer manual PR creation or have strict PR workflows
+**Supported rule file formats:**
-### Enable Rules Detection
+- `.cursorrules` - Cursor AI editor rules
+- `.cursor/rules/*.mdc` - Structured rule files in Cursor directory
+- `.windsurfrules` - Windsurf AI editor rules
+- `CLAUDE.md` - Claude-specific instructions
+- `AGENTS.md` - General agent instructions
+- `AGENT.md` - Agent-specific rules
+
+**When enabled:**
+
+- Agents automatically discover and apply repository-specific rules
+- Rules are version-controlled alongside your code
+- Consistent behavior across team members and environments
+- Supports existing AI editor workflows
+
+**When disabled:**
+
+- Only manually configured repository rules are applied
+- No automatic file-based rule detection
+- Simpler rule management through web interface only
+
+### Enforce Organization-wide Signed Commits
+
+When enabled, **ALL** repositories in this organization will be required to use signed commits via GitHub's API. Individual repositories cannot override this security policy.
+
+**Security benefits:**
+
+- Cryptographic verification of commit authenticity
+- Enhanced audit trail for code changes
+- Compliance with security policies requiring commit signing
+- Protection against commit impersonation
+
+**Important considerations:**
+
+- This is an organization-wide enforcement policy
+- Individual repositories cannot disable this requirement
+- Ensures consistent security posture across all projects
+- May require additional setup for team members' GPG keys
+
+
+ Enabling organization-wide signed commits affects all repositories and cannot
+ be overridden at the repository level. Ensure your team is prepared for this
+ requirement before enabling.
+
+
+## Configuration
+
+Agent permissions are configured at the organization level and provide security boundaries for all agent operations within your organization.
+
+Access your agent permissions at:
+
+
+ Control what actions agents are allowed to perform in your organization.
+
+
+## Permission Combinations
+
+### Development Teams
-**Allow the agent to automatically detect and apply rules from .cursorrules and .windsurfrules files in your repositories.**
+```
+✅ Enable PR Creation
+✅ Enable Rules Detection
+❌ Enforce Signed Commits (unless required)
+```
-This setting enables the agent to automatically discover and follow coding standards, style guides, and other rules defined in your repository's configuration files.
+Standard setup for most development teams wanting full agent capabilities.
-- **Default**: Enabled
-- **Use Case**: Disable if you want to manually control rule application or don't use these rule files
+### Security-Conscious Organizations
-### Enable Linear Self-Assign
+```
+✅ Enable PR Creation
+✅ Enable Rules Detection
+✅ Enforce Signed Commits
+```
-**Allow the codegen agent to self-assign Linear issues, enabling it to spin off other agents.**
+Maximum security with full agent functionality and commit verification.
-When enabled, the agent can assign itself to Linear issues and potentially delegate work to other agent instances for parallel processing.
+### Read-Only Advisory Mode
-- **Default**: Enabled
-- **Use Case**: Disable if you prefer manual issue assignment or want to limit agent autonomy
+```
+❌ Enable PR Creation
+✅ Enable Rules Detection
+❌ Enforce Signed Commits
+```
-### Enable Linear Auto State Change
+Agents provide analysis and suggestions without making direct code changes.
-**When enabled, the agent will automatically move Linear issues to 'Started' state when self-assigning them.**
+### Compliance-First Approach
-This setting automates the workflow by updating issue status when the agent begins work, providing better visibility into what the agent is actively working on.
+```
+✅ Enable PR Creation
+❌ Enable Rules Detection
+✅ Enforce Signed Commits
+```
-- **Default**: Disabled
-- **Use Case**: Enable for automatic issue tracking and improved project visibility
+Strict control with manual rule management and required commit signing.
## Best Practices
-### Security Considerations
+**Start Conservative:**
-- Review permission settings regularly to ensure they align with your team's security policies
-- Consider disabling PR creation in production environments if you require manual review processes
-- Monitor agent activity when enabling self-assignment features
+- Begin with limited permissions and expand as trust builds
+- Enable rules detection to leverage existing team practices
+- Consider PR creation permissions based on repository criticality
-### Workflow Integration
+**Security Considerations:**
-- Enable Linear Auto State Change if your team relies on Linear for project tracking
-- Coordinate permission settings with your existing CI/CD and review processes
-- Consider your team's preferred level of automation when configuring these settings
+- Enable signed commits for organizations with compliance requirements
+- Review agent-created PRs before merging, especially initially
+- Monitor agent activity through analytics and audit logs
-## Related Documentation
+**Team Alignment:**
-- [Repository Rules](/settings/repo-rules) - Configure repository-specific behavior
-- [Linear Integration](/integrations/linear) - Set up Linear workspace integration
-- [Model Configuration](/settings/model-configuration) - Configure LLM settings
+- Ensure team understands which permissions are enabled
+- Provide training on rule file formats if using rules detection
+- Establish clear processes for agent-created PRs
+
+ Permission settings provide essential guardrails for agent operations while
+ maintaining the flexibility to customize based on your organization's security
+ and workflow requirements.
+
diff --git a/docs/settings/settings.mdx b/docs/settings/settings.mdx
new file mode 100644
index 000000000..225486ea7
--- /dev/null
+++ b/docs/settings/settings.mdx
@@ -0,0 +1,81 @@
+---
+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
+
+
+
+ Set repository-specific rules and coding standards that agents automatically
+ follow when working on your codebase.
+
+
+
+## Agent Configuration
+
+
+
+ Configure how agents interact with users and approach code modifications to
+ match your workflow preferences.
+
+
+
+ Control what actions agents are allowed to perform, including PR creation,
+ rules detection, and security policies.
+
+
+
+## Global Configuration
+
+
+
+ Choose your preferred LLM provider and model, configure custom API keys, and
+ optimize performance settings.
+
+
+
+## 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
+- **Agent Behavior** controls how agents interact with users and approach code modifications
+- **Agent Permissions** defines what actions agents are allowed to perform across your organization
+- **Model Configuration** applies globally to your organization and controls which AI models power your agents
+
+
+ Start by configuring repository rules for your most active repositories, then
+ optimize model settings based on your team's performance and cost
+ requirements.
+
+
+
+ Some settings may require specific plan tiers or administrative permissions
+ within your organization.
+