Skip to content

Commit d2481e2

Browse files
jayhackjayhack
committed
.
1 parent c3f65c0 commit d2481e2

File tree

10 files changed

+374
-111
lines changed

10 files changed

+374
-111
lines changed

‎docs/capabilities/checks-autofixer.mdx‎

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
---
2+
title: "Check Suite Auto-fixer"
3+
sidebarTitle: "Checks Auto-fixer"
4+
icon: "bell"
5+
---
6+
7+
When GitHub checks fail on a Codegen PR, Codegen agents will automatically "wake up", analyze the failure, and push fix commit.
8+
9+
This intelligent system monitors CI status and proactively resolves issues without manual intervention.
10+
11+
<Card
12+
title="Configure Check Suite Auto-fixer"
13+
icon="rocket"
14+
href="https://codegen.com/settings/checks-autofixer"
15+
>
16+
Configure globally at the organization level or customize settings per
17+
repository. Enterprise plans can adjust retry limits for optimal performance.
18+
</Card>
19+
20+
<Tip>
21+
Codegen will try to fix broken checks 3 times before "tapping out" by default.
22+
Enterprise customers can customize the retry count per check or per
23+
repository.
24+
</Tip>
25+
26+
## How Checks Auto-Fixer Works
27+
28+
Codegen continuously monitors your pull requests and automatically responds to check failures:
29+
30+
- **Automatic Detection:** Monitors GitHub check runs and CI status in real-time
31+
- **Intelligent Analysis:** Analyzes build logs, test failures, and error messages to understand root causes
32+
- **Targeted Fixes:** Generates specific code changes to resolve the identified issues
33+
- **Persistent Retry:** Will attempt to fix issues up to 3 times per PR
34+
35+
## What Triggers Auto-Fixing
36+
37+
Check auto-fixing activates when:
38+
39+
- **CI Checks Fail:** Any GitHub check run reports a failure status
40+
- **Build Errors:** Compilation, linting, or build process failures
41+
- **Test Failures:** Unit tests, integration tests, or automated test suites fail
42+
- **Code Quality Issues:** Static analysis tools report violations or warnings
43+
44+
## The Auto-Fix Process
45+
46+
When Codegen auto-fixes a failing PR, it follows this process:
47+
48+
1. **Detect Failure:** Monitor check status and identify when builds break
49+
2. **Analyze Logs:** Grep through CI logs to understand specific failure points
50+
3. **Generate Solution:** Create targeted code changes to resolve identified issues
51+
4. **Apply Fix:** Automatically commit fixes to the same PR branch
52+
5. **Re-validate:** Monitor the new check run to ensure the fix was successful
53+
54+
## Retry Logic
55+
56+
Codegen implements intelligent retry behavior:
57+
58+
- **Default: 3 attempts** per PR to resolve failing checks
59+
- **Enterprise customization** - Enterprise customers can configure retry limits:
60+
- Set global defaults at the organization level
61+
- Override per repository in repository settings
62+
- Customize retry counts per individual check type
63+
- **Progressive analysis** - each retry incorporates learnings from previous attempts
64+
- **Failure escalation** - when retry limit is reached, the issue is flagged for human review
65+
66+
## Configuration Options
67+
68+
The Checks Auto-Fixer can be configured at multiple levels:
69+
70+
### Organization Level
71+
72+
- **Global settings** - Configure default behavior for all repositories
73+
- **Available to all plans** - Enable/disable the feature organization-wide
74+
- **Access via** - Organization Settings → Checks Auto-Fixer
75+
76+
### Repository Level
77+
78+
- **Per-repo overrides** - Customize settings for specific repositories
79+
- **Individual check control** - Enable/disable monitoring per check type
80+
- **Custom instructions** - Provide specific guidance for handling each check
81+
- **Access via** - Repository Settings → Checks Auto-Fixer
82+
83+
### Enterprise Features
84+
85+
- **Custom retry limits** - Set retry counts globally, per repository, or per check type
86+
- **Advanced monitoring** - Granular control over which checks to monitor
87+
- **Priority handling** - Configure high-priority checks for immediate processing
88+
89+
## GitHub Integration
90+
91+
The auto-fix system integrates deeply with GitHub:
92+
93+
- **Check Run Annotations:** Creates detailed feedback with line-specific suggestions
94+
- **PR Comments:** Adds contextual suggestions and explanations
95+
- **Auto-Fix Actions:** Provides one-click fix buttons in the GitHub UI
96+
- **Status Updates:** Real-time updates on fix progress and results
97+
98+
<Note>
99+
Checks Auto-Fixer only activates for repositories where Codegen has write
100+
access and the feature is enabled. It respects your repository permissions and
101+
team workflows.
102+
</Note>
103+
104+
## Benefits
105+
106+
- **Reduced Context Switching:** No need to manually investigate and fix CI failures
107+
- **Faster Iteration:** PRs get fixed automatically, keeping development velocity high
108+
- **Learning from Failures:** Each fix improves Codegen's understanding of your codebase
109+
- **24/7 Monitoring:** Works around the clock to keep your PRs in good shape

‎docs/capabilities/wake-up.mdx‎

Lines changed: 0 additions & 67 deletions
This file was deleted.

‎docs/docs.json‎

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,16 +27,23 @@
2727
},
2828
{
2929
"group": "Capabilities",
30-
"pages": ["capabilities/capabilities", "capabilities/wake-up"]
30+
"pages": [
31+
"capabilities/capabilities",
32+
"capabilities/checks-autofixer"
33+
]
3134
},
3235
{
3336
"group": "Integrations",
3437
"pages": [
3538
"integrations/github",
3639
"integrations/slack",
3740
"integrations/linear",
41+
"integrations/clickup",
42+
"integrations/monday",
43+
"integrations/jira",
3844
"integrations/notion",
3945
"integrations/figma",
46+
"integrations/sentry",
4047
"integrations/circleci",
4148
"integrations/web-search",
4249
"integrations/postgres",
@@ -119,7 +126,7 @@
119126
"seo": {
120127
"metatags": {
121128
"og:site_name": "Codegen",
122-
"og:title": "Codegen - The SWE that Never Sleeps",
129+
"og:title": "Codegen - Run Code Agents at Scale",
123130
"og:description": "Code agents accessible via API, Slack, Linear, Github, and more.",
124131
"og:url": "https://docs.codegen.com",
125132
"og:locale": "en_US",

‎docs/integrations/clickup.mdx‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
---
2+
title: "ClickUp Integration"
3+
sidebarTitle: "ClickUp"
4+
icon: "mouse-pointer"
5+
---
6+
7+
import { COMMUNITY_SLACK_URL } from "/snippets/links.mdx";
8+
9+
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.
10+
11+
## Installation
12+
13+
Connect your ClickUp workspace to Codegen to enable agent interactions.
14+
15+
<Card
16+
title="Connect ClickUp Workspace"
17+
icon="mouse-pointer-2"
18+
href="https://codegen.com/integrations/clickup"
19+
>
20+
Authorize Codegen to access your ClickUp workspace and project data.
21+
</Card>
22+
23+
<Note>
24+
The ClickUp integration is currently in <b>beta</b>. Please reach out in the{" "}
25+
<a href={COMMUNITY_SLACK_URL}>community</a> to have it enabled for your
26+
Codegen account.
27+
</Note>
28+
29+
## Capabilities
30+
31+
The ClickUp integration provides comprehensive task management capabilities:
32+
33+
- **Create tasks in your workspace** - Generate new tasks automatically based on development needs and project requirements
34+
- **Update existing tasks and status** - Modify task details, progress, and completion status as work advances
35+
- **Read workspace structure and data** - Access project hierarchies, spaces, folders, and lists to understand organization
36+
- **Add comments to tasks and discussions** - Provide updates, ask questions, and facilitate team collaboration
37+
- **Assign tasks to team members** - Route work to appropriate developers and coordinate team workload
38+
- **Access custom fields and properties** - Work with specialized data fields and project-specific information
39+
- **Read and update task dependencies** - Manage task relationships and project workflow dependencies
40+
- **View workspace members and teams** - Access team structure for proper task assignment and collaboration
41+
42+
## Permissions
43+
44+
The Codegen ClickUp integration requires the following permissions:
45+
46+
- **Create tasks in your workspace** - Generate new tasks and to-do items as needed
47+
- **Update existing tasks and status** - Modify task progress, completion status, and details
48+
- **Read workspace structure and data** - Access project organization, spaces, and folder structures
49+
- **Add comments to tasks and discussions** - Provide updates and facilitate collaboration
50+
- **Assign tasks to team members** - Route work to appropriate team members
51+
- **Access custom fields and properties** - Work with specialized project data and configurations
52+
- **Read and update task dependencies** - Manage workflow relationships between tasks
53+
- **View workspace members and teams** - Access team information for proper task management
54+
55+
## How Agents Use ClickUp
56+
57+
Agents leverage the ClickUp integration to:
58+
59+
- **Track Work:** Automatically update the status of tasks they are working on
60+
- **Create Tasks:** Generate new tasks for follow-up work, bugs discovered, or sub-tasks
61+
- **Link Development:** Connect implemented changes and GitHub PRs directly to relevant ClickUp tasks
62+
- **Provide Updates:** Add comments to tasks with progress reports, results, or questions
63+
- **Manage Dependencies:** Update task relationships as development work progresses
64+
- **Coordinate Teams:** Assign and reassign tasks based on workload and expertise
65+
66+
<Warning>
67+
**Data Access Notice:** Workspace content can be surfaced in agent runs by any
68+
of your Codegen account members. Do not connect sensitive workspaces.
69+
</Warning>
70+
71+
<Note>
72+
The ClickUp integration requires feature flag access. Contact your team
73+
administrator to enable this integration.
74+
</Note>

‎docs/integrations/figma.mdx‎

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,18 @@ icon: "figma"
66

77
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.
88

9+
## Installation
10+
11+
Connect your Figma account to Codegen to enable design-to-code workflows.
12+
13+
<Card
14+
title="Connect Figma Account"
15+
icon="figma"
16+
href="https://codegen.com/integrations/figma"
17+
>
18+
Authorize Codegen to access your Figma files and design resources.
19+
</Card>
20+
921
## Capabilities
1022

1123
The Figma integration enables seamless design-to-code workflows:
@@ -37,19 +49,7 @@ Agents leverage the Figma integration to:
3749
- **Extract Assets:** Pull icons, images, and other visual assets needed for implementation
3850
- **Maintain Design Systems:** Ensure code implementation follows design system guidelines and tokens
3951

40-
## Installation
41-
42-
Connect your Figma account to Codegen to enable design-to-code workflows.
43-
44-
<Card
45-
title="Connect Figma Account"
46-
icon="figma"
47-
href="https://codegen.sh/integrations/figma"
48-
>
49-
Authorize Codegen to access your Figma files and design resources.
50-
</Card>
51-
5252
<Note>
5353
The Figma integration requires feature flag access. Contact your team
5454
administrator to enable this integration.
55-
</Note>{" "}
55+
</Note>

‎docs/integrations/github.mdx‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,18 @@ icon: "github"
66

77
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.
88

9+
## Installation
10+
11+
Authorize Codegen to access your GitHub organizations and repositories.
12+
13+
<Card
14+
title="Install Codegen GitHub App"
15+
icon="github"
16+
href="https://github.com/apps/codegen-sh"
17+
>
18+
Click here to install the Codegen GitHub App and grant necessary permissions.
19+
</Card>
20+
921
## Capabilities
1022

1123
The GitHub integration provides comprehensive development workflow capabilities:
@@ -37,22 +49,10 @@ Agents leverage the GitHub integration to:
3749
- **Request Reviews:** Open pull requests and automatically request reviews from specified team members.
3850
- **Report Progress:** Comment on related issues or PRs with updates, results, or requests for clarification.
3951

40-
## Installation
41-
42-
Authorize Codegen to access your GitHub organizations and repositories.
43-
4452
<Tip>
4553
You can manage repository access granularly through the GitHub App settings.
4654
</Tip>
4755

48-
<Card
49-
title="Install Codegen GitHub App"
50-
icon="github"
51-
href="https://github.com/apps/codegen-sh"
52-
>
53-
Click here to install the Codegen GitHub App and grant necessary permissions.
54-
</Card>
55-
5656
<Note>
5757
Ensure the agent has access to the specific repositories it needs to work on.
5858
</Note>

0 commit comments

Comments
 (0)