Skip to content

Commit 261ea08

Browse files
committed
.
1 parent 84facb4 commit 261ea08

File tree

10 files changed

+281
-43
lines changed

10 files changed

+281
-43
lines changed

docs/docs.json

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,9 @@
3131
"integrations/slack",
3232
"integrations/linear",
3333
"integrations/github",
34+
"integrations/notion",
35+
"integrations/figma",
36+
"integrations/circleci",
3437
"integrations/web-search",
3538
"integrations/postgres"
3639
]

docs/integrations/circleci.mdx

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: "CircleCI Integration"
3+
sidebarTitle: "CircleCI"
4+
icon: "circle-play"
5+
---
6+
7+
Monitor and automatically fix failing CI checks with CircleCI integration. Codegen views check status, analyzes build logs, and automatically fixes issues when PRs fail. When Codegen creates a PR and checks fail, it will automatically wake up to investigate the logs and push fixes.
8+
9+
<Warning>
10+
CircleCI is currently available for enterprise customers. See
11+
[codegen.com/billing](https://codegen.com/billing) for more
12+
</Warning>
13+
14+
## Capabilities
15+
16+
The CircleCI integration enables intelligent check monitoring and automatic issue resolution:
17+
18+
- **View broken checks and failures** - Monitor CI check status and identify specific failure points
19+
- **Analyze build logs and error messages** - Grep through logs to understand root causes of failures
20+
- **Automatically fix failing PRs** - Push corrective changes when checks fail on Codegen-created PRs
21+
- **Wake up on check failures** - Automatically trigger when CI checks fail to investigate and resolve issues
22+
23+
## Permissions
24+
25+
The Codegen CircleCI integration requires the following permissions:
26+
27+
- **Read project information and settings** - Access pipeline configurations and project details
28+
- **View build history and logs** - Monitor pipeline execution and analyze failure logs
29+
- **Read test results and artifacts** - Access build outputs, test reports, and error details
30+
- **Access check status and details** - Monitor CI check results and failure information
31+
32+
<Note>
33+
Codegen operates in read-only mode for CircleCI - it monitors and analyzes but
34+
does not trigger builds or modify CI configurations.
35+
</Note>
36+
37+
## How Agents Use CircleCI
38+
39+
Agents leverage the CircleCI integration to:
40+
41+
- **Monitor Check Status:** Continuously watch for CI check failures on pull requests
42+
- **Analyze Failure Logs:** Grep through build logs to identify specific errors, test failures, or build issues
43+
- **Auto-Fix Issues:** When Codegen creates a PR and checks fail, it automatically investigates and pushes fixes
44+
- **Prevent Broken Merges:** Ensure code quality by resolving CI failures before merge
45+
46+
## Automatic Wake-Up Behavior
47+
48+
When Codegen creates a pull request and CircleCI checks fail, Codegen will automatically:
49+
50+
1. **Detect the failure** - Monitor check status and identify when builds break
51+
2. **Analyze the logs** - Grep through CircleCI logs to understand the specific failure
52+
3. **Generate fixes** - Create targeted code changes to resolve the identified issues
53+
4. **Push updates** - Automatically commit fixes to the same PR branch
54+
55+
This ensures that Codegen-created PRs maintain high quality and don't introduce breaking changes to your codebase.
56+
57+
## Installation
58+
59+
Connect your CircleCI account to Codegen to enable automatic check monitoring and issue resolution.
60+
61+
<Card
62+
title="Connect CircleCI Account"
63+
icon="circle-play"
64+
href="https://codegen.sh/integrations"
65+
>
66+
Authorize Codegen to view your CircleCI check results and build logs.
67+
</Card>
68+
69+
<Note>
70+
Ensure the agent has access to the specific CircleCI projects and
71+
organizations you want it to monitor.
72+
</Note>{" "}

docs/integrations/figma.mdx

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
title: "Figma Integration"
3+
sidebarTitle: "Figma"
4+
icon: "figma"
5+
---
6+
7+
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.
8+
9+
## Capabilities
10+
11+
The Figma integration enables seamless design-to-code workflows:
12+
13+
- **Access design specifications** - Read design files, components, and detailed specifications
14+
- **Extract design assets** - Pull images, icons, and visual elements for implementation
15+
- **Convert designs to code** - Transform design mockups into functional frontend code
16+
- **Sync design changes** - Stay updated with design iterations and modifications
17+
18+
## Permissions
19+
20+
The Codegen Figma integration requires the following permissions:
21+
22+
- **Read your profile and user information** - Access basic account details for authentication
23+
- **Access file contents, nodes, and editor data** - Read design files and component structures
24+
- **Read file metadata and version history** - Track design changes and version information
25+
- **View file comments and discussions** - Understand design context and feedback
26+
- **Access design variables and tokens** - Use consistent design system values
27+
- **Read published components and styles** - Access shared design system components
28+
- **Access team library content** - Use shared assets and design resources
29+
- **List projects and project files** - Navigate and organize design files
30+
31+
## How Agents Use Figma
32+
33+
Agents leverage the Figma integration to:
34+
35+
- **Analyze Designs:** Examine design files to understand layout, styling, and component structure
36+
- **Generate Code:** Convert Figma designs into HTML, CSS, React components, or other frontend code
37+
- **Extract Assets:** Pull icons, images, and other visual assets needed for implementation
38+
- **Maintain Design Systems:** Ensure code implementation follows design system guidelines and tokens
39+
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+
52+
<Note>
53+
The Figma integration requires feature flag access. Contact your team
54+
administrator to enable this integration.
55+
</Note>{" "}

docs/integrations/github.mdx

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,29 @@ sidebarTitle: "GitHub"
44
icon: "github"
55
---
66

7-
Connect Codegen to your GitHub repositories to enable agents to read code, create branches, commit changes, open pull requests, comment on issues, and more.
7+
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

99
## Capabilities
1010

11-
Our GitHub integration grants Codegen agents both read and write access, allowing them to function like a member of your development team:
11+
The GitHub integration provides comprehensive development workflow capabilities:
1212

13-
- **Read Access:** Clone repositories, read file contents, inspect branches, view issues and PRs.
14-
- **Write Access:** Create branches, push commits, open/update pull requests, comment on PRs and issues, assign reviewers.
13+
- **Create and manage pull requests** - Generate, update, and manage PRs with detailed descriptions and context
14+
- **Automated code reviews and feedback** - Provide intelligent code analysis and suggestions
15+
- **Run checks and CI/CD workflows** - Execute automated testing and deployment processes
16+
- **Sync repository changes** - Keep repositories up-to-date and coordinate between branches
17+
18+
## Permissions
19+
20+
The Codegen GitHub integration requires the following permissions to function as a full development team member:
21+
22+
- **Read and write repository contents** - Access code, files, and repository structure
23+
- **Create and manage pull requests** - Generate, update, and merge pull requests
24+
- **Write status checks and CI/CD results** - Report on automated testing and deployment status
25+
- **Read and write issues and comments** - Interact with project issues and provide updates
26+
- **Read repository metadata and settings** - Access repository configuration and settings
27+
- **Read and write GitHub Actions workflows** - Manage automated workflows and CI/CD pipelines
28+
- **Read organization projects and members** - Access team structure and project organization
29+
- **Manage webhooks for real-time updates** - Enable real-time synchronization and notifications
1530

1631
## How Agents Use GitHub
1732

docs/integrations/linear.mdx

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
title: "Linear Integration"
33
sidebarTitle: "Linear"
4-
icon: "book"
4+
icon: "file-lines"
55
---
66

7-
Integrate Codegen with your Linear workspace to allow agents to interact with issues, manage projects, and keep your team updated.
7+
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.
88

99
<img src="/images/linear.png" />
1010

@@ -14,7 +14,7 @@ Connect your Linear workspace to Codegen to enable agent interactions.
1414

1515
<Card
1616
title="Connect Linear Workspace"
17-
icon="pencil"
17+
icon="linear"
1818
href="https://linear.app/integrations/codegen"
1919
>
2020
Authorize Codegen to access your Linear workspace via the API settings.
@@ -27,10 +27,24 @@ Connect your Linear workspace to Codegen to enable agent interactions.
2727

2828
## Capabilities
2929

30-
The Linear integration provides read and write access, enabling agents to manage tasks effectively:
30+
The Linear integration provides comprehensive project management capabilities:
3131

32-
- **Read Access:** Fetch issue details, read comments, view project status, list team members.
33-
- **Write Access:** Update issue status (e.g., to "In Progress", "Done"), add comments, link GitHub PRs to issues, create new issues, assign tasks.
32+
- **Create and update issues automatically** - Generate new tasks and update existing ones based on development needs
33+
- **Track development progress** - Monitor and report on the status of ongoing work
34+
- **Link code changes to tickets** - Connect GitHub pull requests and commits directly to Linear issues
35+
- **Sync status updates** - Keep issue statuses current as work progresses through different stages
36+
37+
## Permissions
38+
39+
The Codegen Linear integration requires the following permissions:
40+
41+
- **Create issues for your workspace** - Generate new tasks and tickets as needed
42+
- **Create issue comments and discussions** - Provide updates, ask questions, and facilitate collaboration
43+
- **Read access to your workspace data** - Access existing issues, projects, and team information
44+
- **Write access to update issues and projects** - Modify issue status, assignees, and project details
45+
- **Assign issues and projects to teams** - Route work to appropriate team members
46+
- **Mention app in issues and documents** - Enable notifications and cross-references
47+
- **Receive realtime updates about workspace changes** - Stay synchronized with workspace activity
3448

3549
## How Agents Use Linear
3650

docs/integrations/notion.mdx

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
title: "Notion Integration"
3+
sidebarTitle: "Notion"
4+
icon: "books"
5+
---
6+
7+
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.
8+
9+
## Capabilities
10+
11+
The Notion integration enables seamless access to your team's knowledge base:
12+
13+
- **Access workspace documentation** - Read and analyze existing documentation, specs, and project requirements
14+
- **Update pages and databases** - Modify content, add comments, and keep documentation current
15+
- **Sync development information** - Bridge the gap between planning documents and code implementation
16+
- **Generate knowledge base content** - Create new documentation based on development work and insights
17+
18+
## Permissions
19+
20+
The Codegen Notion integration requires the following permissions:
21+
22+
- **Read workspace content and documents** - Access existing pages, databases, and documentation
23+
- **Update existing pages and documents** - Modify content and add comments for collaboration
24+
- **Create new pages and content** - Generate new documentation and project materials
25+
- **Access user information and emails** - Understand team structure and collaboration context
26+
- **Read database entries and properties** - Access structured data and project information
27+
- **Update database entries and values** - Modify project data and status information
28+
- **Create new databases and structures** - Establish new organizational systems as needed
29+
30+
## How Agents Use Notion
31+
32+
Agents leverage the Notion integration to:
33+
34+
- **Analyze Requirements:** Read PRDs and technical specifications to understand project scope and requirements
35+
- **Provide Technical Feedback:** Comment on documents with implementation insights and technical considerations
36+
- **Update Documentation:** Keep project documentation current as development progresses
37+
- **Bridge Planning and Code:** Connect high-level planning documents with actual code implementation
38+
39+
## Installation
40+
41+
Connect your Notion workspace to Codegen to enable agent interactions with your knowledge base.
42+
43+
<Card
44+
title="Connect Notion Workspace"
45+
icon="books"
46+
href="https://codegen.sh/integrations/notion"
47+
>
48+
Authorize Codegen to access your Notion workspace and documentation.
49+
</Card>
50+
51+
<Note>
52+
The Notion integration requires feature flag access. Contact your team
53+
administrator to enable this integration.
54+
</Note>{" "}

docs/integrations/slack.mdx

Lines changed: 20 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,16 @@ icon: "slack"
66

77
<img src="/images/slack.png" />
88

9-
Connect Codegen to your Slack workspace to enable seamless communication between agents and your team.
9+
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.
1010

11-
## Capabilities & Functions
11+
## Capabilities
1212

13-
Codegen functions as a full-fledged software engineer that you can interact with directly through Slack. When responding to messages in Slack, Codegen can:
13+
The Slack integration enables seamless collaboration with Codegen directly within your workspace:
1414

15-
- **Perform Research:** Search the web for information, documentation, or solutions to problems.
16-
- **Manage Issues:** Triage and update issues in Linear or GitHub based on your requests.
17-
- **Develop Code:** Make code changes, improvements, or implement new features across your repositories.
18-
- **Create Pull Requests:** Draft, review, and submit PRs with detailed descriptions and context.
19-
- **Provide Updates:** Keep you informed about progress, blockers, or completion of tasks.
20-
- **Request Clarification:** Ask for additional context or guidance when needed to complete a task effectively.
21-
- **Share Results:** Deliver summaries, documentation, links to PRs, or explanations of changes made.
15+
- **Chat with Codegen directly in channels** - Interact naturally through @mentions and direct messages
16+
- **Get real-time notifications** - Stay updated on task progress and completion
17+
- **Share code snippets and updates** - Collaborate on code changes and development tasks
18+
- **Collaborate on development tasks** - Coordinate work across your entire development workflow
2219

2320
All of these capabilities are accessible through natural language interactions in your Slack workspace, allowing your team to leverage Codegen's assistance without context switching between different platforms.
2421

@@ -56,6 +53,19 @@ Codegen responds to the following messages in Slack:
5653
- Sending subsequent messages within a thread routes to the same agent
5754
- New messages in an active thread will interrupt the agent if it's currently working
5855

56+
## Permissions
57+
58+
The Codegen Slack integration requires the following permissions to function effectively:
59+
60+
- **View messages that mention @codegen** - To respond to direct mentions and requests
61+
- **Read message history in public and private channels** - To understand context and conversation flow
62+
- **Send messages and customize appearance** - To communicate and provide updates
63+
- **View and react with emojis** - To acknowledge messages and provide feedback
64+
- **Access shared files and attachments** - To review and work with shared content
65+
- **Read direct messages and group chats** - To enable private conversations with the agent
66+
- **View workspace members and email addresses** - To understand team structure and routing
67+
- **Access basic channel information** - To operate appropriately within different channel contexts
68+
5969
## Data Privacy and Security
6070

6171
**Message Content Handling:**

docs/integrations/web-search.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Agents utilize web search capabilities to:
2828

2929
Web search is automatically available to agents when needed, powered by exa's advanced search capabilities.
3030

31-
<Card title="Learn More About exa" icon="globe" href="https://exa.ai">
31+
<Card title="Learn more about Exa" icon="globe" href="https://exa.ai">
3232
Discover how exa powers our web search capabilities with state-of-the-art
3333
search technology.
3434
</Card>

0 commit comments

Comments
 (0)