From d2481e2c66b840e14177f3eef4078aed450437b0 Mon Sep 17 00:00:00 2001 From: jayhack Date: Sun, 14 Sep 2025 11:20:03 -0700 Subject: [PATCH 01/10] . --- docs/capabilities/checks-autofixer.mdx | 109 +++++++++++++++++++++++++ docs/capabilities/wake-up.mdx | 67 --------------- docs/docs.json | 11 ++- docs/integrations/clickup.mdx | 74 +++++++++++++++++ docs/integrations/figma.mdx | 26 +++--- docs/integrations/github.mdx | 24 +++--- docs/integrations/jira.mdx | 29 ++++++- docs/integrations/monday.mdx | 56 +++++++++++++ docs/integrations/notion.mdx | 26 +++--- docs/integrations/sentry.mdx | 63 ++++++++++++++ 10 files changed, 374 insertions(+), 111 deletions(-) create mode 100644 docs/capabilities/checks-autofixer.mdx delete mode 100644 docs/capabilities/wake-up.mdx create mode 100644 docs/integrations/clickup.mdx create mode 100644 docs/integrations/monday.mdx create mode 100644 docs/integrations/sentry.mdx diff --git a/docs/capabilities/checks-autofixer.mdx b/docs/capabilities/checks-autofixer.mdx new file mode 100644 index 000000000..0366573e0 --- /dev/null +++ b/docs/capabilities/checks-autofixer.mdx @@ -0,0 +1,109 @@ +--- +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/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..badd32dfd 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -27,7 +27,10 @@ }, { "group": "Capabilities", - "pages": ["capabilities/capabilities", "capabilities/wake-up"] + "pages": [ + "capabilities/capabilities", + "capabilities/checks-autofixer" + ] }, { "group": "Integrations", @@ -35,8 +38,12 @@ "integrations/github", "integrations/slack", "integrations/linear", + "integrations/clickup", + "integrations/monday", + "integrations/jira", "integrations/notion", "integrations/figma", + "integrations/sentry", "integrations/circleci", "integrations/web-search", "integrations/postgres", @@ -119,7 +126,7 @@ "seo": { "metatags": { "og:site_name": "Codegen", - "og:title": "Codegen - The SWE that Never Sleeps", + "og:title": "Codegen - Run Code Agents at Scale", "og:description": "Code agents accessible via API, Slack, Linear, Github, and more.", "og:url": "https://docs.codegen.com", "og:locale": "en_US", diff --git a/docs/integrations/clickup.mdx b/docs/integrations/clickup.mdx new file mode 100644 index 000000000..e506a38c7 --- /dev/null +++ b/docs/integrations/clickup.mdx @@ -0,0 +1,74 @@ +--- +title: "ClickUp Integration" +sidebarTitle: "ClickUp" +icon: "mouse-pointer" +--- + +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/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/monday.mdx b/docs/integrations/monday.mdx new file mode 100644 index 000000000..03faa213a --- /dev/null +++ b/docs/integrations/monday.mdx @@ -0,0 +1,56 @@ +--- +title: "Monday.com Integration" +sidebarTitle: "Monday.com" +icon: "kanban" +--- + +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..2dac70747 100644 --- a/docs/integrations/notion.mdx +++ b/docs/integrations/notion.mdx @@ -6,6 +6,18 @@ icon: "books" 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..1a4b589e6 --- /dev/null +++ b/docs/integrations/sentry.mdx @@ -0,0 +1,63 @@ +--- +title: "Sentry Integration" +sidebarTitle: "Sentry" +icon: "pyramid" +--- + +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. + From bcfae5834774a373fa2e622c7698dc5f0d162d09 Mon Sep 17 00:00:00 2001 From: jayhack Date: Sun, 14 Sep 2025 12:10:58 -0700 Subject: [PATCH 02/10] . --- docs/capabilities/pr-review.mdx | 125 ++++++++++++++++++++++++++++++ docs/docs.json | 11 +-- docs/integrations/clickup.mdx | 4 +- docs/integrations/mcp-servers.mdx | 82 ++++++++++++++++++++ docs/integrations/monday.mdx | 4 +- docs/integrations/sentry.mdx | 4 +- 6 files changed, 219 insertions(+), 11 deletions(-) create mode 100644 docs/capabilities/pr-review.mdx create mode 100644 docs/integrations/mcp-servers.mdx diff --git a/docs/capabilities/pr-review.mdx b/docs/capabilities/pr-review.mdx new file mode 100644 index 000000000..3a3941751 --- /dev/null +++ b/docs/capabilities/pr-review.mdx @@ -0,0 +1,125 @@ +--- +title: "PR Review Agent" +sidebarTitle: "PR Review" +icon: "eye" +--- + +Codegen agents automatically review your pull requests, providing intelligent feedback, suggestions, and code analysis to improve code quality and catch issues before they reach production. + +This intelligent system analyzes code changes, identifies potential problems, and provides actionable feedback to help maintain high code quality standards. + + + Configure PR review settings at the organization level or customize per + repository. Set review criteria, feedback preferences, and integration + options. + + + + The PR Review Agent provides comprehensive code analysis including security + vulnerabilities, performance issues, code style violations, and logical + errors. + + +## How PR Review Works + +Codegen automatically reviews your pull requests with intelligent analysis: + +- **Automatic Triggering:** Monitors new pull requests and code changes in real-time +- **Comprehensive Analysis:** Reviews code for bugs, security issues, performance problems, and style violations +- **Contextual Feedback:** Provides specific, actionable suggestions with line-by-line comments +- **Integration Aware:** Understands your codebase patterns, dependencies, and architectural decisions + +## What Triggers PR Review + +PR review activates when: + +- **New Pull Requests:** Any new PR opened in monitored repositories +- **Code Updates:** New commits pushed to existing pull request branches +- **Review Requests:** Manual review requests through GitHub or other integrations +- **Scheduled Reviews:** Periodic reviews of long-running or draft pull requests + +## The Review Process + +When Codegen reviews a pull request, it follows this comprehensive process: + +1. **Code Analysis:** Deep analysis of all changed files and their context +2. **Pattern Recognition:** Identifies common issues, anti-patterns, and potential bugs +3. **Security Scanning:** Checks for security vulnerabilities and sensitive data exposure +4. **Performance Review:** Analyzes code for performance bottlenecks and optimization opportunities +5. **Style Compliance:** Ensures code follows established style guides and best practices +6. **Contextual Feedback:** Generates specific, actionable comments and suggestions + +## Review Categories + +The PR Review Agent analyzes multiple aspects of your code: + +### Code Quality + +- **Logic Errors:** Identifies potential bugs and logical inconsistencies +- **Code Complexity:** Highlights overly complex functions that need refactoring +- **Maintainability:** Suggests improvements for code readability and maintainability +- **Best Practices:** Ensures adherence to language and framework best practices + +### Security Analysis + +- **Vulnerability Detection:** Scans for common security vulnerabilities (SQL injection, XSS, etc.) +- **Sensitive Data:** Identifies potential exposure of secrets, API keys, or personal data +- **Access Control:** Reviews authentication and authorization implementations +- **Dependency Security:** Checks for known vulnerabilities in dependencies + +### Performance Optimization + +- **Algorithmic Efficiency:** Identifies inefficient algorithms and data structures +- **Resource Usage:** Reviews memory usage, database queries, and API calls +- **Caching Opportunities:** Suggests areas where caching could improve performance +- **Scalability Concerns:** Highlights potential bottlenecks for high-traffic scenarios + +## Configuration Options + +The PR Review Agent can be configured at multiple levels: + +### Organization Level + +- **Global settings** - Configure default review behavior for all repositories +- **Review criteria** - Set standards for code quality, security, and performance +- **Access via** - Organization Settings → PR Review + +### Repository Level + +- **Per-repo customization** - Tailor review settings for specific repositories +- **Language-specific rules** - Configure rules based on programming languages used +- **Integration preferences** - Choose how and where review feedback is delivered +- **Access via** - Repository Settings → PR Review + +### Team Preferences + +- **Review thoroughness** - Adjust detail level from basic to comprehensive +- **Feedback style** - Choose between concise suggestions or detailed explanations +- **Priority focus** - Emphasize security, performance, or code quality based on team needs + +## GitHub Integration + +The PR review system integrates seamlessly with GitHub: + +- **Inline Comments:** Provides specific feedback on individual lines of code +- **Review Summaries:** Creates comprehensive review summaries with overall assessment +- **Status Checks:** Integrates with GitHub's review system and status checks +- **Approval Workflow:** Can be configured to require addressing feedback before merging + +## Benefits + +- **Improved Code Quality:** Consistent, thorough reviews catch issues early in the development process +- **Knowledge Sharing:** Reviews help team members learn best practices and coding standards +- **Security Enhancement:** Automated security scanning reduces vulnerability risks +- **Faster Reviews:** Reduces time spent on manual code reviews while maintaining quality +- **Continuous Learning:** The system learns from your codebase and improves over time + + + PR Review Agent only activates for repositories where Codegen has read access + and the feature is enabled. It respects your repository permissions and review + workflows. + diff --git a/docs/docs.json b/docs/docs.json index badd32dfd..2617a761e 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -29,7 +29,8 @@ "group": "Capabilities", "pages": [ "capabilities/capabilities", - "capabilities/checks-autofixer" + "capabilities/checks-autofixer", + "capabilities/pr-review" ] }, { @@ -38,11 +39,11 @@ "integrations/github", "integrations/slack", "integrations/linear", - "integrations/clickup", - "integrations/monday", - "integrations/jira", "integrations/notion", "integrations/figma", + "integrations/jira", + "integrations/clickup", + "integrations/monday", "integrations/sentry", "integrations/circleci", "integrations/web-search", @@ -126,7 +127,7 @@ "seo": { "metatags": { "og:site_name": "Codegen", - "og:title": "Codegen - Run Code Agents at Scale", + "og:title": "Codegen - The SWE that Never Sleeps", "og:description": "Code agents accessible via API, Slack, Linear, Github, and more.", "og:url": "https://docs.codegen.com", "og:locale": "en_US", diff --git a/docs/integrations/clickup.mdx b/docs/integrations/clickup.mdx index e506a38c7..85c69d2e9 100644 --- a/docs/integrations/clickup.mdx +++ b/docs/integrations/clickup.mdx @@ -1,7 +1,7 @@ --- title: "ClickUp Integration" sidebarTitle: "ClickUp" -icon: "mouse-pointer" +icon: "feather" --- import { COMMUNITY_SLACK_URL } from "/snippets/links.mdx"; @@ -14,7 +14,7 @@ Connect your ClickUp workspace to Codegen to enable agent interactions. Authorize Codegen to access your ClickUp workspace and project data. 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/monday.mdx b/docs/integrations/monday.mdx index 03faa213a..4a778483c 100644 --- a/docs/integrations/monday.mdx +++ b/docs/integrations/monday.mdx @@ -1,7 +1,7 @@ --- title: "Monday.com Integration" sidebarTitle: "Monday.com" -icon: "kanban" +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. @@ -12,7 +12,7 @@ Connect your Monday.com workspace to Codegen to enable agent interactions. Authorize Codegen to access your Monday.com workspace and project boards. diff --git a/docs/integrations/sentry.mdx b/docs/integrations/sentry.mdx index 1a4b589e6..9028b931c 100644 --- a/docs/integrations/sentry.mdx +++ b/docs/integrations/sentry.mdx @@ -1,7 +1,7 @@ --- title: "Sentry Integration" sidebarTitle: "Sentry" -icon: "pyramid" +icon: "triangle" --- import { COMMUNITY_SLACK_URL } from "/snippets/links.mdx"; @@ -14,7 +14,7 @@ Connect your Sentry organization to Codegen to enable agent interactions with er Authorize Codegen to access your Sentry organization and error data. From 8a4fcedeade0e6acdf22a3c4041865286de2ca87 Mon Sep 17 00:00:00 2001 From: jayhack Date: Sun, 14 Sep 2025 12:42:31 -0700 Subject: [PATCH 03/10] . --- docs/capabilities/pr-review.mdx | 122 +++++++------------------------- 1 file changed, 25 insertions(+), 97 deletions(-) diff --git a/docs/capabilities/pr-review.mdx b/docs/capabilities/pr-review.mdx index 3a3941751..4772024f7 100644 --- a/docs/capabilities/pr-review.mdx +++ b/docs/capabilities/pr-review.mdx @@ -4,122 +4,50 @@ sidebarTitle: "PR Review" icon: "eye" --- -Codegen agents automatically review your pull requests, providing intelligent feedback, suggestions, and code analysis to improve code quality and catch issues before they reach production. - -This intelligent system analyzes code changes, identifies potential problems, and provides actionable feedback to help maintain high code quality standards. +Codegen provides a configurable AI code review feature similar to CodeRabbit, Graphite, or Greptile as a first-class feature. - Configure PR review settings at the organization level or customize per - repository. Set review criteria, feedback preferences, and integration - options. + Set up PR review at the organization level, then customize per repository. - - The PR Review Agent provides comprehensive code analysis including security - vulnerabilities, performance issues, code style violations, and logical - errors. - - -## How PR Review Works - -Codegen automatically reviews your pull requests with intelligent analysis: - -- **Automatic Triggering:** Monitors new pull requests and code changes in real-time -- **Comprehensive Analysis:** Reviews code for bugs, security issues, performance problems, and style violations -- **Contextual Feedback:** Provides specific, actionable suggestions with line-by-line comments -- **Integration Aware:** Understands your codebase patterns, dependencies, and architectural decisions - -## What Triggers PR Review - -PR review activates when: - -- **New Pull Requests:** Any new PR opened in monitored repositories -- **Code Updates:** New commits pushed to existing pull request branches -- **Review Requests:** Manual review requests through GitHub or other integrations -- **Scheduled Reviews:** Periodic reviews of long-running or draft pull requests - -## The Review Process - -When Codegen reviews a pull request, it follows this comprehensive process: - -1. **Code Analysis:** Deep analysis of all changed files and their context -2. **Pattern Recognition:** Identifies common issues, anti-patterns, and potential bugs -3. **Security Scanning:** Checks for security vulnerabilities and sensitive data exposure -4. **Performance Review:** Analyzes code for performance bottlenecks and optimization opportunities -5. **Style Compliance:** Ensures code follows established style guides and best practices -6. **Contextual Feedback:** Generates specific, actionable comments and suggestions +## How It Works -## Review Categories +When you open a PR or push new commits, Codegen agents analyze the changes and provide: -The PR Review Agent analyzes multiple aspects of your code: +- **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 -### Code Quality +## Configuration -- **Logic Errors:** Identifies potential bugs and logical inconsistencies -- **Code Complexity:** Highlights overly complex functions that need refactoring -- **Maintainability:** Suggests improvements for code readability and maintainability -- **Best Practices:** Ensures adherence to language and framework best practices +Configure PR reviews at two levels: -### Security Analysis +### Organization Settings -- **Vulnerability Detection:** Scans for common security vulnerabilities (SQL injection, XSS, etc.) -- **Sensitive Data:** Identifies potential exposure of secrets, API keys, or personal data -- **Access Control:** Reviews authentication and authorization implementations -- **Dependency Security:** Checks for known vulnerabilities in dependencies +Set global defaults and organization-wide review rules at [Organization Settings → PR Review](https://codegen.com/settings/review). -### Performance Optimization +### Repository Settings -- **Algorithmic Efficiency:** Identifies inefficient algorithms and data structures -- **Resource Usage:** Reviews memory usage, database queries, and API calls -- **Caching Opportunities:** Suggests areas where caching could improve performance -- **Scalability Concerns:** Highlights potential bottlenecks for high-traffic scenarios +Override settings and add repository-specific rules at **Repository Settings → Review**. -## Configuration Options +Repository rules are combined with organization rules for comprehensive coverage. You can: -The PR Review Agent can be configured at multiple levels: +- Enable/disable PR reviews for the repository +- Add custom review guidelines specific to the codebase +- Define language-specific requirements +- Set repository-specific coding standards -### Organization Level - -- **Global settings** - Configure default review behavior for all repositories -- **Review criteria** - Set standards for code quality, security, and performance -- **Access via** - Organization Settings → PR Review - -### Repository Level - -- **Per-repo customization** - Tailor review settings for specific repositories -- **Language-specific rules** - Configure rules based on programming languages used -- **Integration preferences** - Choose how and where review feedback is delivered -- **Access via** - Repository Settings → PR Review - -### Team Preferences - -- **Review thoroughness** - Adjust detail level from basic to comprehensive -- **Feedback style** - Choose between concise suggestions or detailed explanations -- **Priority focus** - Emphasize security, performance, or code quality based on team needs - -## GitHub Integration - -The PR review system integrates seamlessly with GitHub: - -- **Inline Comments:** Provides specific feedback on individual lines of code -- **Review Summaries:** Creates comprehensive review summaries with overall assessment -- **Status Checks:** Integrates with GitHub's review system and status checks -- **Approval Workflow:** Can be configured to require addressing feedback before merging - -## Benefits - -- **Improved Code Quality:** Consistent, thorough reviews catch issues early in the development process -- **Knowledge Sharing:** Reviews help team members learn best practices and coding standards -- **Security Enhancement:** Automated security scanning reduces vulnerability risks -- **Faster Reviews:** Reduces time spent on manual code reviews while maintaining quality -- **Continuous Learning:** The system learns from your codebase and improves over time + + Start with organization-level settings, then customize individual repositories + as needed. + - PR Review Agent only activates for repositories where Codegen has read access - and the feature is enabled. It respects your repository permissions and review - workflows. + PR reviews require read access to your repository. Enable the feature at both + organization and repository levels to activate reviews. From c372cd8810a8510656ad4587a21f0b07ce3d19f1 Mon Sep 17 00:00:00 2001 From: jayhack Date: Sun, 14 Sep 2025 14:29:47 -0700 Subject: [PATCH 04/10] . --- docs/docs.json | 6 +- docs/integrations/integrations.mdx | 103 +++++++++++++++++++++++++++++ docs/integrations/linear.mdx | 4 +- docs/integrations/mcp.mdx | 3 + docs/integrations/notion.mdx | 2 +- 5 files changed, 111 insertions(+), 7 deletions(-) create mode 100644 docs/integrations/integrations.mdx diff --git a/docs/docs.json b/docs/docs.json index 2617a761e..d14059163 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -36,6 +36,7 @@ { "group": "Integrations", "pages": [ + "integrations/integrations", "integrations/github", "integrations/slack", "integrations/linear", @@ -48,10 +49,7 @@ "integrations/circleci", "integrations/web-search", "integrations/postgres", - { - "group": "integrations/mcp", - "name": "Remote MCP Server" - } + "integrations/mcp-servers" ] }, { diff --git a/docs/integrations/integrations.mdx b/docs/integrations/integrations.mdx new file mode 100644 index 000000000..456bc349c --- /dev/null +++ b/docs/integrations/integrations.mdx @@ -0,0 +1,103 @@ +--- +title: "Integrations" +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. + +## 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/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.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/notion.mdx b/docs/integrations/notion.mdx index 2dac70747..4de002e9f 100644 --- a/docs/integrations/notion.mdx +++ b/docs/integrations/notion.mdx @@ -1,7 +1,7 @@ --- 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. From cc12640a69136f90a9a1ce8e86116ffc09665086 Mon Sep 17 00:00:00 2001 From: jayhack Date: Sun, 14 Sep 2025 14:38:42 -0700 Subject: [PATCH 05/10] . --- docs/capabilities/checks-autofixer.mdx | 6 +++ docs/docs.json | 16 +++++--- docs/integrations/integrations.mdx | 10 ++++- docs/settings/settings.mdx | 51 ++++++++++++++++++++++++++ 4 files changed, 76 insertions(+), 7 deletions(-) create mode 100644 docs/settings/settings.mdx diff --git a/docs/capabilities/checks-autofixer.mdx b/docs/capabilities/checks-autofixer.mdx index 0366573e0..3648e6be3 100644 --- a/docs/capabilities/checks-autofixer.mdx +++ b/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. +