diff --git a/docs/gen/how-it-works.mdx b/docs/gen/how-it-works.mdx
new file mode 100644
index 000000000..37c25a06e
--- /dev/null
+++ b/docs/gen/how-it-works.mdx
@@ -0,0 +1,117 @@
+---
+title: "How Codegen Works"
+sidebarTitle: "How It Works"
+icon: "gears"
+iconType: "solid"
+---
+
+# How Codegen Works
+
+Codegen is an expert software engineering agent designed to help development teams build better software. This document explains the architecture and workflow of Codegen.
+
+## Architecture Overview
+
+Codegen operates through a sophisticated system with several key components:
+
+
+ 
+
+
+### Core Components
+
+1. **Trigger System**
+ - Monitors various channels (Slack, GitHub, Linear, API)
+ - Detects when users mention or interact with Codegen
+ - Captures context from the triggering environment
+
+2. **Context Gathering**
+ - Analyzes the codebase structure
+ - Retrieves relevant information from integrations
+ - Builds a comprehensive understanding of the task
+
+3. **Task Planning**
+ - Breaks down complex requests into actionable steps
+ - Determines the optimal approach to solve the problem
+ - Identifies required tools and resources
+
+4. **Execution Engine**
+ - Runs commands in a sandboxed environment
+ - Makes code changes through precise edits
+ - Interacts with external services via API
+
+5. **Response Generation**
+ - Creates clear, concise responses
+ - Formats information appropriately for the channel
+ - Provides links to relevant resources
+
+## Workflow
+
+When you interact with Codegen, the following process occurs:
+
+1. **Trigger**: You mention Codegen in Slack, tag it in a GitHub PR, or interact with it in Linear
+2. **Context Analysis**: Codegen gathers relevant information about your request
+3. **Planning**: It determines the best approach to solve your problem
+4. **Execution**: Codegen performs necessary actions (code analysis, edits, searches)
+5. **Response**: It provides a helpful response in the same channel where you triggered it
+
+## Available Tools
+
+Codegen has access to a powerful set of tools:
+
+### Code Analysis & Navigation
+- Search codebases using text or regex patterns
+- View file contents and metadata
+- Analyze code structure and dependencies
+- Reveal symbol definitions and usages
+
+### File Operations
+- View, create, edit, and delete files
+- Rename files while updating all imports
+- Move symbols between files
+- Commit changes to disk
+
+### Semantic Editing
+- Make precise, context-aware code edits
+- Analyze affected code structures
+- Preview changes before applying
+- Ensure code quality with linting
+
+### Web Search
+- Search the web for information
+- View specific web pages for reference
+
+### Integration Tools
+- Create and manage GitHub issues and PRs
+- Interact with Linear tickets
+- Send messages in Slack
+- And more...
+
+## Best Practices for Working with Codegen
+
+To get the most out of Codegen:
+
+1. **Be Specific**: Clearly describe what you want Codegen to do
+2. **Provide Context**: Mention relevant files, issues, or PRs
+3. **Break Down Complex Tasks**: Ask for one thing at a time for best results
+4. **Review Changes**: Always review PRs created by Codegen before merging
+5. **Provide Feedback**: Let Codegen know if its response was helpful
+
+## Security and Privacy
+
+Codegen operates with security as a priority:
+
+- All code operations happen in isolated sandboxed environments
+- Codegen only accesses repositories you've explicitly granted it access to
+- Your code is never used to train AI models
+- All operations follow the principle of least privilege
+
+## Limitations
+
+While powerful, Codegen has some limitations:
+
+- It cannot access private networks or systems outside its integrations
+- Very large codebases may take longer to analyze
+- Complex architectural decisions still benefit from human oversight
+- It works best with well-structured, documented code
+
+For more information about Codegen's capabilities, see the [Capabilities](/gen/capabilities) page.
diff --git a/docs/gen/use-cases.mdx b/docs/gen/use-cases.mdx
new file mode 100644
index 000000000..bf803a783
--- /dev/null
+++ b/docs/gen/use-cases.mdx
@@ -0,0 +1,196 @@
+---
+title: "Common Use Cases"
+sidebarTitle: "Use Cases"
+icon: "lightbulb"
+iconType: "solid"
+---
+
+# Common Use Cases for Codegen
+
+Codegen is designed to streamline your development workflow and help you accomplish tasks more efficiently. Here are some common ways teams use Codegen:
+
+## Code Research and Understanding
+
+
+
+ ```
+ @codegen How does the authentication flow work in our app?
+ ```
+
+ Codegen will analyze the codebase, identify authentication-related files, and explain the flow with relevant code snippets and diagrams.
+
+
+
+ ```
+ @codegen Show me examples of how we use the API client in our codebase
+ ```
+
+ Codegen will search for and present examples of API client usage across your codebase, helping you understand patterns and conventions.
+
+
+
+ ```
+ @codegen Trace the execution path of the processPayment function
+ ```
+
+ Codegen will analyze the call graph to show you how the function is called, what dependencies it has, and what other functions it calls.
+
+
+
+## Code Modifications and Refactoring
+
+
+
+ ```
+ @codegen Add input validation to the user registration form
+ ```
+
+ Codegen will locate the registration form, implement appropriate validation logic, and create a PR with the changes.
+
+
+
+ ```
+ @codegen Fix the issue where the dashboard doesn't load user data
+ ```
+
+ Codegen will investigate the issue, identify the root cause, and implement a fix with appropriate error handling.
+
+
+
+ ```
+ @codegen Refactor the UserService class to use dependency injection
+ ```
+
+ Codegen will restructure the class to follow dependency injection patterns while maintaining functionality.
+
+
+
+ ```
+ @codegen Update our React components to use the latest API
+ ```
+
+ Codegen will identify components using deprecated APIs and update them to use the current recommended patterns.
+
+
+
+## Code Reviews and Quality
+
+
+
+ ```
+ @codegen Review PR #123
+ ```
+
+ Codegen will analyze the PR, provide feedback on code quality, suggest improvements, and identify potential issues.
+
+
+
+ ```
+ @codegen Add unit tests for the PaymentProcessor class
+ ```
+
+ Codegen will create comprehensive tests covering different scenarios and edge cases for the specified class.
+
+
+
+ ```
+ @codegen Check our error handling in the API routes
+ ```
+
+ Codegen will analyze error handling patterns, identify inconsistencies or gaps, and suggest improvements.
+
+
+
+## Documentation and Knowledge Sharing
+
+
+
+ ```
+ @codegen Create documentation for our authentication API
+ ```
+
+ Codegen will analyze the API and create comprehensive documentation with endpoints, parameters, and examples.
+
+
+
+ ```
+ @codegen Explain the caching strategy in our app
+ ```
+
+ Codegen will analyze the caching implementation and provide a clear explanation with diagrams and examples.
+
+
+
+ ```
+ @codegen Create a guide for new developers on our project structure
+ ```
+
+ Codegen will generate a comprehensive guide explaining the project's architecture, key components, and conventions.
+
+
+
+## Project Management
+
+
+
+ ```
+ @codegen Find all issues related to authentication
+ ```
+
+ Codegen will search through Linear or GitHub issues to find and summarize authentication-related tasks.
+
+
+
+ ```
+ @codegen Break down the task of implementing the new notification system
+ ```
+
+ Codegen will analyze the requirements and create a detailed breakdown of subtasks needed to implement the feature.
+
+
+
+ ```
+ @codegen What's the status of our API migration project?
+ ```
+
+ Codegen will gather information from issues, PRs, and commits to provide a comprehensive status update.
+
+
+
+## Advanced Use Cases
+
+
+
+ ```
+ @codegen Convert all our Promise-based code to use async/await
+ ```
+
+ Codegen can help plan and execute large-scale code transformations across your codebase.
+
+
+
+ ```
+ @codegen Analyze our microservice dependencies
+ ```
+
+ Codegen will map out service dependencies, identify potential bottlenecks, and suggest architectural improvements.
+
+
+
+ ```
+ @codegen Identify performance bottlenecks in our rendering logic
+ ```
+
+ Codegen will analyze the code for performance issues and suggest optimizations with measurable impact.
+
+
+
+## Getting Started
+
+To start using Codegen for these use cases:
+
+1. [Install Codegen](https://codegen.sh/install) and connect it to your GitHub, Slack, and Linear accounts
+2. Mention `@codegen` in your Slack channel followed by your request
+3. Review Codegen's response and provide feedback to help it improve
+
+For more detailed information on Codegen's capabilities, see the [Capabilities](/gen/capabilities) page.
diff --git a/docs/mint.json b/docs/mint.json
index 737c098ee..b5c36a49d 100644
--- a/docs/mint.json
+++ b/docs/mint.json
@@ -1,396 +1,396 @@
{
- "$schema": "https://mintlify.com/schema.json",
- "name": "Codegen",
- "logo": {
- "dark": "https://cdn.prod.website-files.com/67070304751b9b01bf6a161c/679bcf45a3e32761c42b324b_Codegen_Logomark_Dark.svg",
- "light": "https://cdn.prod.website-files.com/67070304751b9b01bf6a161c/679bcf45bf55446746125835_Codegen_Logomark_Light.svg"
- },
- "modeToggle": {
- "default": "dark"
- },
- "metadata": {
- "og:site_name": "Codegen",
- "og:title": "Codegen - Manipulate Code at Scale",
- "og:description": "A scriptable interface to a powerful, multi-lingual language server built on top of Tree-sitter.",
- "og:url": "https://docs.codegen.com",
- "og:locale": "en_US",
- "og:logo": "https://i.imgur.com/f4OVOqI.png",
- "article:publisher": "Codegen, Inc.",
- "twitter:site": "@codegen"
- },
- "favicon": "/favicon.svg",
- "colors": {
- "primary": "#a277ff",
- "light": "#a277ff",
- "dark": "#a277ff",
- "anchors": {
- "from": "#61ffca",
- "to": "#61ffca"
- }
- },
- "theme": "prism",
- "background": {
- "style": "gradient"
- },
- "analytics": {
- "posthog": {
- "apiKey": "phc_GLxaINoQJnuyCyxDmTciQqzdKBYFVDkY7bRBO4bDdso"
- }
- },
- "feedback": {
- "thumbsRating": true
- },
- "topbarCtaButton": {
- "name": "GitHub",
- "url": "https://github.com/codegen-sh/codegen-sdk"
- },
- "tabs": [
- {
- "name": "API Reference",
- "url": "/api-reference"
- },
- {
- "name": "CLI",
- "url": "/cli"
- },
- {
- "name": "Blog",
- "url": "/blog"
- },
- {
- "name": "Changelog",
- "url": "/changelog"
- },
- {
- "name": "codegen",
- "url": "/gen"
- }
- ],
- "navigation": [
- {
- "group": "Introduction",
- "pages": [
- "introduction/overview",
- "introduction/getting-started",
- "introduction/installation",
- "introduction/ide-usage",
- "introduction/work-with-ai",
- "introduction/how-it-works",
- "introduction/advanced-settings",
- "introduction/guiding-principles",
- "introduction/community",
- "introduction/about",
- "introduction/faq"
- ]
- },
- {
- "group": "Tutorials",
- "pages": [
- "tutorials/at-a-glance",
- "tutorials/build-code-agent",
- "tutorials/slack-bot",
- "tutorials/github-review-bot",
- "tutorials/deep-code-research",
- "tutorials/codebase-analytics-dashboard",
- "tutorials/training-data",
- "tutorials/codebase-visualization",
- "tutorials/migrating-apis",
- "tutorials/organize-your-codebase",
- "tutorials/promise-to-async-await",
- "tutorials/modularity",
- "tutorials/manage-feature-flags",
- "tutorials/deleting-dead-code",
- "tutorials/increase-type-coverage",
- "tutorials/managing-typescript-exports",
- "tutorials/converting-default-exports",
- "tutorials/creating-documentation",
- "tutorials/react-modernization",
- "tutorials/unittest-to-pytest",
- "tutorials/sqlalchemy-1.6-to-2.0",
- "tutorials/fixing-import-loops-in-pytorch",
- "tutorials/python2-to-python3",
- "tutorials/flask-to-fastapi",
- "tutorials/build-mcp",
- "tutorials/neo4j-graph",
- "tutorials/attributions"
- ]
- },
- {
- "group": "Building with Codegen",
- "pages": [
- "building-with-codegen/at-a-glance",
- "building-with-codegen/parsing-codebases",
- "building-with-codegen/reusable-codemods",
- "building-with-codegen/dot-codegen",
- "building-with-codegen/function-decorator",
- "building-with-codegen/language-support",
- "building-with-codegen/commit-and-reset",
- "building-with-codegen/git-operations",
- "building-with-codegen/files-and-directories",
- "building-with-codegen/the-editable-api",
- "building-with-codegen/symbol-api",
- "building-with-codegen/class-api",
- "building-with-codegen/imports",
- "building-with-codegen/exports",
- "building-with-codegen/inheritable-behaviors",
- "building-with-codegen/statements-and-code-blocks",
- "building-with-codegen/dependencies-and-usages",
- "building-with-codegen/function-calls-and-callsites",
- "building-with-codegen/variable-assignments",
- "building-with-codegen/local-variables",
- "building-with-codegen/comments-and-docstrings",
- "building-with-codegen/external-modules",
- "building-with-codegen/type-annotations",
- "building-with-codegen/moving-symbols",
- "building-with-codegen/collections",
- "building-with-codegen/traversing-the-call-graph",
- "building-with-codegen/react-and-jsx",
- "building-with-codegen/codebase-visualization",
- "building-with-codegen/flagging-symbols",
- "building-with-codegen/calling-out-to-llms",
- "building-with-codegen/semantic-code-search",
- "building-with-codegen/reducing-conditions"
- ]
- },
- {
- "group": "CLI",
- "pages": [
- "cli/about",
- "cli/init",
- "cli/notebook",
- "cli/create",
- "cli/run",
- "cli/reset",
- "cli/expert"
- ]
- },
- {
- "group": "Changelog",
- "pages": [
- "changelog/changelog"
- ]
- },
- {
- "group": "Blog",
- "pages": [
- "blog/posts",
- "blog/devin",
- "blog/act-via-code",
- "blog/promise-to-async-await-twilio",
- "blog/fixing-import-loops"
- ]
- },
- {
- "group": "codegen",
- "pages": [
- "gen/introduction",
- "gen/capabilities",
- "gen/integrations",
- "gen/faq"
- ]
- },
- {
- "group": "API Reference",
- "pages": [
- "api-reference/index",
- {
- "group": "Core",
- "icon": "code",
- "pages": [
- "api-reference/core/Argument",
- "api-reference/core/Assignment",
- "api-reference/core/AssignmentStatement",
- "api-reference/core/Attribute",
- "api-reference/core/AwaitExpression",
- "api-reference/core/BinaryExpression",
- "api-reference/core/BlockStatement",
- "api-reference/core/Boolean",
- "api-reference/core/Callable",
- "api-reference/core/CatchStatement",
- "api-reference/core/ChainedAttribute",
- "api-reference/core/Class",
- "api-reference/core/CodeBlock",
- "api-reference/core/CodeOwner",
- "api-reference/core/Codebase",
- "api-reference/core/Comment",
- "api-reference/core/CommentGroup",
- "api-reference/core/ComparisonExpression",
- "api-reference/core/Decorator",
- "api-reference/core/Dict",
- "api-reference/core/Directory",
- "api-reference/core/Editable",
- "api-reference/core/Export",
- "api-reference/core/ExportStatement",
- "api-reference/core/Exportable",
- "api-reference/core/Expression",
- "api-reference/core/ExpressionGroup",
- "api-reference/core/ExpressionStatement",
- "api-reference/core/ExternalModule",
- "api-reference/core/File",
- "api-reference/core/FlagKwargs",
- "api-reference/core/ForLoopStatement",
- "api-reference/core/Function",
- "api-reference/core/FunctionCall",
- "api-reference/core/GenericType",
- "api-reference/core/HasBlock",
- "api-reference/core/HasName",
- "api-reference/core/HasValue",
- "api-reference/core/IfBlockStatement",
- "api-reference/core/Import",
- "api-reference/core/ImportStatement",
- "api-reference/core/ImportType",
- "api-reference/core/Importable",
- "api-reference/core/Interface",
- "api-reference/core/List",
- "api-reference/core/MessageType",
- "api-reference/core/MultiExpression",
- "api-reference/core/MultiLineCollection",
- "api-reference/core/Name",
- "api-reference/core/NamedType",
- "api-reference/core/NoneType",
- "api-reference/core/Number",
- "api-reference/core/Pair",
- "api-reference/core/Parameter",
- "api-reference/core/ParenthesizedExpression",
- "api-reference/core/Placeholder",
- "api-reference/core/PlaceholderType",
- "api-reference/core/RaiseStatement",
- "api-reference/core/ReturnStatement",
- "api-reference/core/SourceFile",
- "api-reference/core/Span",
- "api-reference/core/Statement",
- "api-reference/core/StatementType",
- "api-reference/core/String",
- "api-reference/core/StubPlaceholder",
- "api-reference/core/SubscriptExpression",
- "api-reference/core/SwitchCase",
- "api-reference/core/SwitchStatement",
- "api-reference/core/Symbol",
- "api-reference/core/SymbolGroup",
- "api-reference/core/SymbolStatement",
- "api-reference/core/TernaryExpression",
- "api-reference/core/TryCatchStatement",
- "api-reference/core/Tuple",
- "api-reference/core/TupleType",
- "api-reference/core/Type",
- "api-reference/core/TypeAlias",
- "api-reference/core/TypePlaceholder",
- "api-reference/core/Typeable",
- "api-reference/core/UnaryExpression",
- "api-reference/core/UnionType",
- "api-reference/core/Unpack",
- "api-reference/core/Unwrappable",
- "api-reference/core/Usable",
- "api-reference/core/Usage",
- "api-reference/core/UsageKind",
- "api-reference/core/UsageType",
- "api-reference/core/Value",
- "api-reference/core/WhileStatement",
- "api-reference/core/WithStatement"
- ]
- },
- {
- "group": "Python",
- "icon": "python",
- "pages": [
- "api-reference/python/PyAssignment",
- "api-reference/python/PyAssignmentStatement",
- "api-reference/python/PyAttribute",
- "api-reference/python/PyBlockStatement",
- "api-reference/python/PyBreakStatement",
- "api-reference/python/PyCatchStatement",
- "api-reference/python/PyChainedAttribute",
- "api-reference/python/PyClass",
- "api-reference/python/PyCodeBlock",
- "api-reference/python/PyComment",
- "api-reference/python/PyCommentGroup",
- "api-reference/python/PyCommentType",
- "api-reference/python/PyConditionalExpression",
- "api-reference/python/PyDecorator",
- "api-reference/python/PyFile",
- "api-reference/python/PyForLoopStatement",
- "api-reference/python/PyFunction",
- "api-reference/python/PyGenericType",
- "api-reference/python/PyHasBlock",
- "api-reference/python/PyIfBlockStatement",
- "api-reference/python/PyImport",
- "api-reference/python/PyImportStatement",
- "api-reference/python/PyMatchCase",
- "api-reference/python/PyMatchStatement",
- "api-reference/python/PyNamedType",
- "api-reference/python/PyParameter",
- "api-reference/python/PyPassStatement",
- "api-reference/python/PyReturnTypePlaceholder",
- "api-reference/python/PyString",
- "api-reference/python/PySymbol",
- "api-reference/python/PyTryCatchStatement",
- "api-reference/python/PyUnionType",
- "api-reference/python/PyWhileStatement"
- ]
- },
- {
- "group": "Typescript",
- "icon": "js",
- "pages": [
- "api-reference/typescript/JSXElement",
- "api-reference/typescript/JSXExpression",
- "api-reference/typescript/JSXProp",
- "api-reference/typescript/TSArrayType",
- "api-reference/typescript/TSAssignment",
- "api-reference/typescript/TSAssignmentStatement",
- "api-reference/typescript/TSAttribute",
- "api-reference/typescript/TSBlockStatement",
- "api-reference/typescript/TSCatchStatement",
- "api-reference/typescript/TSChainedAttribute",
- "api-reference/typescript/TSClass",
- "api-reference/typescript/TSCodeBlock",
- "api-reference/typescript/TSComment",
- "api-reference/typescript/TSCommentGroup",
- "api-reference/typescript/TSCommentType",
- "api-reference/typescript/TSConditionalType",
- "api-reference/typescript/TSConfig",
- "api-reference/typescript/TSDecorator",
- "api-reference/typescript/TSDict",
- "api-reference/typescript/TSEnum",
- "api-reference/typescript/TSExport",
- "api-reference/typescript/TSExpressionType",
- "api-reference/typescript/TSFile",
- "api-reference/typescript/TSForLoopStatement",
- "api-reference/typescript/TSFunction",
- "api-reference/typescript/TSFunctionType",
- "api-reference/typescript/TSGenericType",
- "api-reference/typescript/TSHasBlock",
- "api-reference/typescript/TSIfBlockStatement",
- "api-reference/typescript/TSImport",
- "api-reference/typescript/TSImportStatement",
- "api-reference/typescript/TSInterface",
- "api-reference/typescript/TSLabeledStatement",
- "api-reference/typescript/TSLookupType",
- "api-reference/typescript/TSNamedType",
- "api-reference/typescript/TSNamespace",
- "api-reference/typescript/TSObjectType",
- "api-reference/typescript/TSPair",
- "api-reference/typescript/TSParameter",
- "api-reference/typescript/TSQueryType",
- "api-reference/typescript/TSReadonlyType",
- "api-reference/typescript/TSReturnTypePlaceholder",
- "api-reference/typescript/TSString",
- "api-reference/typescript/TSSwitchCase",
- "api-reference/typescript/TSSwitchStatement",
- "api-reference/typescript/TSSymbol",
- "api-reference/typescript/TSTernaryExpression",
- "api-reference/typescript/TSTryCatchStatement",
- "api-reference/typescript/TSTypeAlias",
- "api-reference/typescript/TSUndefinedType",
- "api-reference/typescript/TSUnionType",
- "api-reference/typescript/TSWhileStatement"
- ]
- }
- ]
- }
- ],
- "footerSocials": {
- "x": "https://x.com/codegen",
- "linkedin": "https://linkedin.com/company/codegen-dot-com"
- }
-}
\ No newline at end of file
+ "$schema": "https://mintlify.com/schema.json",
+ "name": "Codegen",
+ "logo": {
+ "dark": "https://cdn.prod.website-files.com/67070304751b9b01bf6a161c/679bcf45a3e32761c42b324b_Codegen_Logomark_Dark.svg",
+ "light": "https://cdn.prod.website-files.com/67070304751b9b01bf6a161c/679bcf45bf55446746125835_Codegen_Logomark_Light.svg"
+ },
+ "modeToggle": {
+ "default": "dark"
+ },
+ "metadata": {
+ "og:site_name": "Codegen",
+ "og:title": "Codegen - Manipulate Code at Scale",
+ "og:description": "A scriptable interface to a powerful, multi-lingual language server built on top of Tree-sitter.",
+ "og:url": "https://docs.codegen.com",
+ "og:locale": "en_US",
+ "og:logo": "https://i.imgur.com/f4OVOqI.png",
+ "article:publisher": "Codegen, Inc.",
+ "twitter:site": "@codegen"
+ },
+ "favicon": "/favicon.svg",
+ "colors": {
+ "primary": "#a277ff",
+ "light": "#a277ff",
+ "dark": "#a277ff",
+ "anchors": {
+ "from": "#61ffca",
+ "to": "#61ffca"
+ }
+ },
+ "theme": "prism",
+ "background": {
+ "style": "gradient"
+ },
+ "analytics": {
+ "posthog": {
+ "apiKey": "phc_GLxaINoQJnuyCyxDmTciQqzdKBYFVDkY7bRBO4bDdso"
+ }
+ },
+ "feedback": {
+ "thumbsRating": true
+ },
+ "topbarCtaButton": {
+ "name": "GitHub",
+ "url": "https://github.com/codegen-sh/codegen-sdk"
+ },
+ "tabs": [
+ {
+ "name": "API Reference",
+ "url": "/api-reference"
+ },
+ {
+ "name": "CLI",
+ "url": "/cli"
+ },
+ {
+ "name": "Blog",
+ "url": "/blog"
+ },
+ {
+ "name": "Changelog",
+ "url": "/changelog"
+ },
+ {
+ "name": "codegen",
+ "url": "/gen"
+ }
+ ],
+ "navigation": [
+ {
+ "group": "Introduction",
+ "pages": [
+ "introduction/overview",
+ "introduction/getting-started",
+ "introduction/installation",
+ "introduction/ide-usage",
+ "introduction/work-with-ai",
+ "introduction/how-it-works",
+ "introduction/advanced-settings",
+ "introduction/guiding-principles",
+ "introduction/community",
+ "introduction/about",
+ "introduction/faq"
+ ]
+ },
+ {
+ "group": "Tutorials",
+ "pages": [
+ "tutorials/at-a-glance",
+ "tutorials/build-code-agent",
+ "tutorials/slack-bot",
+ "tutorials/github-review-bot",
+ "tutorials/deep-code-research",
+ "tutorials/codebase-analytics-dashboard",
+ "tutorials/training-data",
+ "tutorials/codebase-visualization",
+ "tutorials/migrating-apis",
+ "tutorials/organize-your-codebase",
+ "tutorials/promise-to-async-await",
+ "tutorials/modularity",
+ "tutorials/manage-feature-flags",
+ "tutorials/deleting-dead-code",
+ "tutorials/increase-type-coverage",
+ "tutorials/managing-typescript-exports",
+ "tutorials/converting-default-exports",
+ "tutorials/creating-documentation",
+ "tutorials/react-modernization",
+ "tutorials/unittest-to-pytest",
+ "tutorials/sqlalchemy-1.6-to-2.0",
+ "tutorials/fixing-import-loops-in-pytorch",
+ "tutorials/python2-to-python3",
+ "tutorials/flask-to-fastapi",
+ "tutorials/build-mcp",
+ "tutorials/neo4j-graph",
+ "tutorials/attributions"
+ ]
+ },
+ {
+ "group": "Building with Codegen",
+ "pages": [
+ "building-with-codegen/at-a-glance",
+ "building-with-codegen/parsing-codebases",
+ "building-with-codegen/reusable-codemods",
+ "building-with-codegen/dot-codegen",
+ "building-with-codegen/function-decorator",
+ "building-with-codegen/language-support",
+ "building-with-codegen/commit-and-reset",
+ "building-with-codegen/git-operations",
+ "building-with-codegen/files-and-directories",
+ "building-with-codegen/the-editable-api",
+ "building-with-codegen/symbol-api",
+ "building-with-codegen/class-api",
+ "building-with-codegen/imports",
+ "building-with-codegen/exports",
+ "building-with-codegen/inheritable-behaviors",
+ "building-with-codegen/statements-and-code-blocks",
+ "building-with-codegen/dependencies-and-usages",
+ "building-with-codegen/function-calls-and-callsites",
+ "building-with-codegen/variable-assignments",
+ "building-with-codegen/local-variables",
+ "building-with-codegen/comments-and-docstrings",
+ "building-with-codegen/external-modules",
+ "building-with-codegen/type-annotations",
+ "building-with-codegen/moving-symbols",
+ "building-with-codegen/collections",
+ "building-with-codegen/traversing-the-call-graph",
+ "building-with-codegen/react-and-jsx",
+ "building-with-codegen/codebase-visualization",
+ "building-with-codegen/flagging-symbols",
+ "building-with-codegen/calling-out-to-llms",
+ "building-with-codegen/semantic-code-search",
+ "building-with-codegen/reducing-conditions"
+ ]
+ },
+ {
+ "group": "CLI",
+ "pages": [
+ "cli/about",
+ "cli/init",
+ "cli/notebook",
+ "cli/create",
+ "cli/run",
+ "cli/reset",
+ "cli/expert"
+ ]
+ },
+ {
+ "group": "Changelog",
+ "pages": ["changelog/changelog"]
+ },
+ {
+ "group": "Blog",
+ "pages": [
+ "blog/posts",
+ "blog/devin",
+ "blog/act-via-code",
+ "blog/promise-to-async-await-twilio",
+ "blog/fixing-import-loops"
+ ]
+ },
+ {
+ "group": "codegen",
+ "pages": [
+ "gen/introduction",
+ "gen/capabilities",
+ "gen/how-it-works",
+ "gen/use-cases",
+ "gen/integrations",
+ "gen/faq"
+ ]
+ },
+ {
+ "group": "API Reference",
+ "pages": [
+ "api-reference/index",
+ {
+ "group": "Core",
+ "icon": "code",
+ "pages": [
+ "api-reference/core/Argument",
+ "api-reference/core/Assignment",
+ "api-reference/core/AssignmentStatement",
+ "api-reference/core/Attribute",
+ "api-reference/core/AwaitExpression",
+ "api-reference/core/BinaryExpression",
+ "api-reference/core/BlockStatement",
+ "api-reference/core/Boolean",
+ "api-reference/core/Callable",
+ "api-reference/core/CatchStatement",
+ "api-reference/core/ChainedAttribute",
+ "api-reference/core/Class",
+ "api-reference/core/CodeBlock",
+ "api-reference/core/CodeOwner",
+ "api-reference/core/Codebase",
+ "api-reference/core/Comment",
+ "api-reference/core/CommentGroup",
+ "api-reference/core/ComparisonExpression",
+ "api-reference/core/Decorator",
+ "api-reference/core/Dict",
+ "api-reference/core/Directory",
+ "api-reference/core/Editable",
+ "api-reference/core/Export",
+ "api-reference/core/ExportStatement",
+ "api-reference/core/Exportable",
+ "api-reference/core/Expression",
+ "api-reference/core/ExpressionGroup",
+ "api-reference/core/ExpressionStatement",
+ "api-reference/core/ExternalModule",
+ "api-reference/core/File",
+ "api-reference/core/FlagKwargs",
+ "api-reference/core/ForLoopStatement",
+ "api-reference/core/Function",
+ "api-reference/core/FunctionCall",
+ "api-reference/core/GenericType",
+ "api-reference/core/HasBlock",
+ "api-reference/core/HasName",
+ "api-reference/core/HasValue",
+ "api-reference/core/IfBlockStatement",
+ "api-reference/core/Import",
+ "api-reference/core/ImportStatement",
+ "api-reference/core/ImportType",
+ "api-reference/core/Importable",
+ "api-reference/core/Interface",
+ "api-reference/core/List",
+ "api-reference/core/MessageType",
+ "api-reference/core/MultiExpression",
+ "api-reference/core/MultiLineCollection",
+ "api-reference/core/Name",
+ "api-reference/core/NamedType",
+ "api-reference/core/NoneType",
+ "api-reference/core/Number",
+ "api-reference/core/Pair",
+ "api-reference/core/Parameter",
+ "api-reference/core/ParenthesizedExpression",
+ "api-reference/core/Placeholder",
+ "api-reference/core/PlaceholderType",
+ "api-reference/core/RaiseStatement",
+ "api-reference/core/ReturnStatement",
+ "api-reference/core/SourceFile",
+ "api-reference/core/Span",
+ "api-reference/core/Statement",
+ "api-reference/core/StatementType",
+ "api-reference/core/String",
+ "api-reference/core/StubPlaceholder",
+ "api-reference/core/SubscriptExpression",
+ "api-reference/core/SwitchCase",
+ "api-reference/core/SwitchStatement",
+ "api-reference/core/Symbol",
+ "api-reference/core/SymbolGroup",
+ "api-reference/core/SymbolStatement",
+ "api-reference/core/TernaryExpression",
+ "api-reference/core/TryCatchStatement",
+ "api-reference/core/Tuple",
+ "api-reference/core/TupleType",
+ "api-reference/core/Type",
+ "api-reference/core/TypeAlias",
+ "api-reference/core/TypePlaceholder",
+ "api-reference/core/Typeable",
+ "api-reference/core/UnaryExpression",
+ "api-reference/core/UnionType",
+ "api-reference/core/Unpack",
+ "api-reference/core/Unwrappable",
+ "api-reference/core/Usable",
+ "api-reference/core/Usage",
+ "api-reference/core/UsageKind",
+ "api-reference/core/UsageType",
+ "api-reference/core/Value",
+ "api-reference/core/WhileStatement",
+ "api-reference/core/WithStatement"
+ ]
+ },
+ {
+ "group": "Python",
+ "icon": "python",
+ "pages": [
+ "api-reference/python/PyAssignment",
+ "api-reference/python/PyAssignmentStatement",
+ "api-reference/python/PyAttribute",
+ "api-reference/python/PyBlockStatement",
+ "api-reference/python/PyBreakStatement",
+ "api-reference/python/PyCatchStatement",
+ "api-reference/python/PyChainedAttribute",
+ "api-reference/python/PyClass",
+ "api-reference/python/PyCodeBlock",
+ "api-reference/python/PyComment",
+ "api-reference/python/PyCommentGroup",
+ "api-reference/python/PyCommentType",
+ "api-reference/python/PyConditionalExpression",
+ "api-reference/python/PyDecorator",
+ "api-reference/python/PyFile",
+ "api-reference/python/PyForLoopStatement",
+ "api-reference/python/PyFunction",
+ "api-reference/python/PyGenericType",
+ "api-reference/python/PyHasBlock",
+ "api-reference/python/PyIfBlockStatement",
+ "api-reference/python/PyImport",
+ "api-reference/python/PyImportStatement",
+ "api-reference/python/PyMatchCase",
+ "api-reference/python/PyMatchStatement",
+ "api-reference/python/PyNamedType",
+ "api-reference/python/PyParameter",
+ "api-reference/python/PyPassStatement",
+ "api-reference/python/PyReturnTypePlaceholder",
+ "api-reference/python/PyString",
+ "api-reference/python/PySymbol",
+ "api-reference/python/PyTryCatchStatement",
+ "api-reference/python/PyUnionType",
+ "api-reference/python/PyWhileStatement"
+ ]
+ },
+ {
+ "group": "Typescript",
+ "icon": "js",
+ "pages": [
+ "api-reference/typescript/JSXElement",
+ "api-reference/typescript/JSXExpression",
+ "api-reference/typescript/JSXProp",
+ "api-reference/typescript/TSArrayType",
+ "api-reference/typescript/TSAssignment",
+ "api-reference/typescript/TSAssignmentStatement",
+ "api-reference/typescript/TSAttribute",
+ "api-reference/typescript/TSBlockStatement",
+ "api-reference/typescript/TSCatchStatement",
+ "api-reference/typescript/TSChainedAttribute",
+ "api-reference/typescript/TSClass",
+ "api-reference/typescript/TSCodeBlock",
+ "api-reference/typescript/TSComment",
+ "api-reference/typescript/TSCommentGroup",
+ "api-reference/typescript/TSCommentType",
+ "api-reference/typescript/TSConditionalType",
+ "api-reference/typescript/TSConfig",
+ "api-reference/typescript/TSDecorator",
+ "api-reference/typescript/TSDict",
+ "api-reference/typescript/TSEnum",
+ "api-reference/typescript/TSExport",
+ "api-reference/typescript/TSExpressionType",
+ "api-reference/typescript/TSFile",
+ "api-reference/typescript/TSForLoopStatement",
+ "api-reference/typescript/TSFunction",
+ "api-reference/typescript/TSFunctionType",
+ "api-reference/typescript/TSGenericType",
+ "api-reference/typescript/TSHasBlock",
+ "api-reference/typescript/TSIfBlockStatement",
+ "api-reference/typescript/TSImport",
+ "api-reference/typescript/TSImportStatement",
+ "api-reference/typescript/TSInterface",
+ "api-reference/typescript/TSLabeledStatement",
+ "api-reference/typescript/TSLookupType",
+ "api-reference/typescript/TSNamedType",
+ "api-reference/typescript/TSNamespace",
+ "api-reference/typescript/TSObjectType",
+ "api-reference/typescript/TSPair",
+ "api-reference/typescript/TSParameter",
+ "api-reference/typescript/TSQueryType",
+ "api-reference/typescript/TSReadonlyType",
+ "api-reference/typescript/TSReturnTypePlaceholder",
+ "api-reference/typescript/TSString",
+ "api-reference/typescript/TSSwitchCase",
+ "api-reference/typescript/TSSwitchStatement",
+ "api-reference/typescript/TSSymbol",
+ "api-reference/typescript/TSTernaryExpression",
+ "api-reference/typescript/TSTryCatchStatement",
+ "api-reference/typescript/TSTypeAlias",
+ "api-reference/typescript/TSUndefinedType",
+ "api-reference/typescript/TSUnionType",
+ "api-reference/typescript/TSWhileStatement"
+ ]
+ }
+ ]
+ }
+ ],
+ "footerSocials": {
+ "x": "https://x.com/codegen",
+ "linkedin": "https://linkedin.com/company/codegen-dot-com"
+ }
+}