diff --git a/docs/capabilities/capabilities.mdx b/docs/capabilities/capabilities.mdx index 68845b007..abe6146fe 100644 --- a/docs/capabilities/capabilities.mdx +++ b/docs/capabilities/capabilities.mdx @@ -38,7 +38,7 @@ Agents activate seamlessly from the platforms you already use: - **[ClickUp](/integrations/clickup)** - Assign a task to Codegen or mention it in comments - **[Monday.com](/integrations/monday)** - Assign an item to Codegen or mention it in comments - **[GitHub](/integrations/github)** - Comment on issues or PRs to request changes -- **[API](http://localhost:3001/api-reference/agents/create-agent-run)** - Programmatically trigger agents for automated workflows +- **[API](/api-reference/agents/create-agent-run)** - Programmatically trigger agents for automated workflows ### 2. `@codegen` Performs Work in Secure Sandboxes diff --git a/docs/docs.json b/docs/docs.json index be1d9c4ac..2b1cc3eee 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -34,7 +34,8 @@ "capabilities/claude-code", "capabilities/analytics", "introduction/cli", - "introduction/sdk" + "introduction/sdk", + "settings/on-prem-deployment" ] }, { @@ -46,8 +47,7 @@ "settings/agent-behavior", "settings/agent-permissions", "settings/team-roles", - "settings/trufflehog-integration", - "settings/on-prem-deployment" + "settings/trufflehog-integration" ] }, { diff --git a/docs/integrations/integrations.mdx b/docs/integrations/integrations.mdx index bb25474ea..ba43a69c9 100644 --- a/docs/integrations/integrations.mdx +++ b/docs/integrations/integrations.mdx @@ -41,15 +41,11 @@ Connect your favorite platforms to enable agents that understand your context an 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. diff --git a/docs/introduction/about.mdx b/docs/introduction/about.mdx index f6a065a30..e51c975b8 100644 --- a/docs/introduction/about.mdx +++ b/docs/introduction/about.mdx @@ -61,7 +61,7 @@ We believe in the power of open source software. Our core library, [codegen](htt - Want to learn more about what we're building? Check out our [getting started - guide](/introduction/getting-started) or join our [community - Slack](https://community.codegen.com). + Want to learn more about what we're building? Start with the [overview + guide](/introduction/overview) or join our + [community Slack](https://community.codegen.com). diff --git a/docs/introduction/cli.mdx b/docs/introduction/cli.mdx index 36c41be62..7f49a9d08 100644 --- a/docs/introduction/cli.mdx +++ b/docs/introduction/cli.mdx @@ -5,6 +5,11 @@ icon: "terminal" iconType: "solid" --- +import { + COMMUNITY_SLACK_URL, + CODEGEN_SDK_GITHUB_URL, +} from "/snippets/links.mdx"; + The `codegen` CLI is your terminal interface to Codegen agents. Use it to view agents, pull their work, create new agents, and run Claude Code with full telemetry and monitoring. @@ -93,15 +98,13 @@ codegen update --dry-run ## Get Started -import { - COMMUNITY_SLACK_URL, - CODEGEN_SDK_GITHUB_URL, -} from "/snippets/links.mdx"; - Sign up for a free account and get your API token. + + Chat with the team, share feedback, and get help in Slack. + Star us on GitHub and contribute to the project. diff --git a/docs/introduction/community.mdx b/docs/introduction/community.mdx index ed02a4276..ae045d2a8 100644 --- a/docs/introduction/community.mdx +++ b/docs/introduction/community.mdx @@ -26,7 +26,7 @@ Join the growing Codegen community! We're excited to have you be part of our jou Learn how to use Codegen effectively with our comprehensive guides. diff --git a/docs/introduction/guiding-principles.mdx b/docs/introduction/guiding-principles.mdx deleted file mode 100644 index 53201e5c1..000000000 --- a/docs/introduction/guiding-principles.mdx +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: "Guiding Principles" -sidebarTitle: "Principles" -icon: "compass" -iconType: "solid" ---- - -Codegen was developed by working backwards from real-world, large-scale codebase migrations. Instead of starting with abstract syntax trees and parser theory, we started with the question: "How do developers actually think about code changes?" - -This practical origin led to four core principles that shape Codegen's design: - -## Intuitive APIs - -Write code that reads like natural language, without worrying about abstract syntax trees or parser internals. Codegen provides high-level APIs that map directly to the transformations developers want to perform: - -```python -# Methods that read like English -function.rename("new_name") # Not ast.update_node(function_node, "name", "new_name") -function.move_to_file("new_file.py") # Not ast.relocate_node(function_node, "new_file.py") - -# Clean, readable properties -if function.is_async: # Not ast.get_node_attribute(function_node, "async") - print(function.name) # Not ast.get_node_name(function_node) - -# Natural iteration patterns -for usage in function.usages: # Not ast.find_references(function_node) - print(f"Used in {usage.file.name}") -``` - -## No Sharp Edges - -Focus on your high-level intent while Codegen handles the intricate details. - -Codegen operations handle the edge cases - it should be hard to break lint. - -```python -# Moving a function? Codegen handles: -function.move_to_file("new_file.py") -# ✓ Updating all import statements -# ✓ Preserving dependencies -# ✓ Maintaining references -# ✓ Fixing relative imports -# ✓ Resolving naming conflicts - -# Renaming a symbol? Codegen manages: -class_def.rename("NewName") -# ✓ Updating all usages -# ✓ Handling string references -# ✓ Preserving docstrings -# ✓ Maintaining inheritance -``` - -## Performance through Pre-Computation - -Codegen frontloads as much as possible to enable fast, efficient transformations. - -It is built with the insight that each codebase only needs to be parsed once per commit. - - - Learn more about parsing the codebase graph in the [How it - Works](/introduction/how-it-works) guide. - - -## Python-First Composability - -Codegen embraces Python's strength as a "glue language" - its ability to seamlessly integrate different tools and APIs. This makes it natural to compose Codegen with your existing toolchain: - -- Build complex transforms by combining simpler operations -- Integrate Codegen with your existing tools (linters, type checkers, test frameworks, AI tools) - - - Python's rich ecosystem makes it ideal for code manipulation tasks. Codegen is - designed to be one tool in your toolbox, not a replacement for your entire - workflow. - diff --git a/docs/introduction/how-it-works.mdx b/docs/introduction/how-it-works.mdx deleted file mode 100644 index 8777a5be4..000000000 --- a/docs/introduction/how-it-works.mdx +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: "Under the Hood" -sidebarTitle: "How it Works" -icon: "gear" -iconType: "solid" -subtitle: "How Codegen's codebase graph works" ---- - -Codegen performs advanced static analysis to build a rich graph representation of your codebase. This pre-computation step analyzes dependencies, references, types, and control flow to enable fast and reliable code manipulation operations. - - - Codegen is built on top of - [Tree-sitter](https://tree-sitter.github.io/tree-sitter/) and - [rustworkx](https://github.com/Qiskit/rustworkx) and has implemented most - language server features from scratch. - - - Codegen is open source. Check out the [source - code](https://github.com/codegen-sh/codegen-sdk) to learn more! - - -## The Codebase Graph - -At the heart of Codegen is a comprehensive graph representation of your code. When you initialize a [Codebase](/api-reference/core/Codebase), it performs static analysis to construct a rich graph structure connecting code elements: - -```python -# Initialize and analyze the codebase -from codegen import Codebase -codebase = Codebase("./") - -# Access pre-computed relationships -function = codebase.get_symbol("process_data") -print(f"Dependencies: {function.dependencies}") # Instant lookup -print(f"Usages: {function.usages}") # No parsing needed -``` - -### Building the Graph - -Codegen's graph construction happens in two stages: - -1. **AST Parsing**: We use [Tree-sitter](https://tree-sitter.github.io/tree-sitter/) as our foundation for parsing code into Abstract Syntax Trees. Tree-sitter provides fast, reliable parsing across multiple languages. - -2. **Multi-file Graph Construction**: Custom parsing logic, implemented in [rustworkx](https://github.com/Qiskit/rustworkx) and Python, analyzes these ASTs to construct a more sophisticated graph structure. This graph captures relationships between [symbols](/building-with-codegen/symbol-api), [files](/building-with-codegen/files-and-directories), [imports](/building-with-codegen/imports), and more. - -### Performance Through Pre-computation - -Pre-computing a rich index enables Codegen to make certain operations very fast that that are relevant to refactors and code analysis: - -- Finding all usages of a symbol -- Detecting circular dependencies -- Analyzing the dependency graphs -- Tracing call graphs -- Static analysis-based code retrieval for RAG -- ...etc. - - - Pre-parsing the codebase enables constant-time lookups rather than requiring - re-parsing or real-time analysis. - - -## Multi-Language Support - -One of Codegen's core principles is that many programming tasks are fundamentally similar across languages. - -Currently, Codegen supports: - -- [Python](/api-reference/python) -- [TypeScript](/api-reference/typescript) -- [React & JSX](/building-with-codegen/react-and-jsx) - - - Learn about how Codegen handles language specifics in the [Language - Support](/building-with-codegen/language-support) guide. - - -We've started with these ecosystems but designed our architecture to be extensible. The graph-based approach provides a consistent interface across languages while handling language-specific details under the hood. - -## Build with Us - -Codegen is just getting started, and we're excited about the possibilities ahead. We enthusiastically welcome contributions from the community, whether it's: - -- Adding support for new languages -- Implementing new analysis capabilities -- Improving performance -- Expanding the API -- Adding new transformations -- Improving documentation - -Check out our [community guide](/introduction/community) to get involved! diff --git a/docs/introduction/overview.mdx b/docs/introduction/overview.mdx index 6f79fccca..f66d991e7 100644 --- a/docs/introduction/overview.mdx +++ b/docs/introduction/overview.mdx @@ -60,8 +60,8 @@ Codegen agents come equipped with a versatile set of tools and capabilities: custom MCP tools. - Connect with Slack, Linear, Figma, databases, and extend capabilities with - custom MCP tools. + Deliver actionable pull request reviews with inline suggestions and follow-up + commits handled by the agent. -On-premises deployment is available exclusively for [Enterprise tier](https://codegen.com/pricing) customers. - - -## Overview - -Our Kubernetes-native architecture ensures seamless integration with your existing infrastructure and security policies. With on-premises deployment, your code and data never leave your infrastructure, giving you complete sovereignty over your intellectual property. + + On-premises deployment is available for [Enterprise + tier](https://codegen.com/pricing) customers. + -## Key Features +## How It Works -### Flexible Deployment Options -Available for deployment as a Docker image, AMI, or on EKS - you can select your hardware and infrastructure to meet your specific requirements. +Codegen is built as a cloud-native Kubernetes application designed for secure, self-hosted deployment. Our architecture allows you to run the entire platform within your own infrastructure while leveraging [your own AI models and API keys](/settings/model-configuration) for complete control over data processing. This deployment model is ideal for teams with stringent data sovereignty requirements, air-gapped environments, or compliance mandates that require all code and development activities to remain within corporate boundaries. -### Your Own API Keys -Use your own model and API keys, including AWS Bedrock, Google Vertex AI, and other providers for complete control over your AI infrastructure. - -Learn more about [model configuration](/settings/model-configuration). - -### Complete Data Control -Your code and data never leave your infrastructure. Maintain complete sovereignty over your intellectual property while benefiting from Codegen's powerful development acceleration capabilities. +## Deployment Options -### AWS Marketplace Ready +Choose the deployment method that best fits your infrastructure: + + + + Deploy using our containerized solution on any Docker-compatible platform + + + Launch pre-configured instances directly from Amazon Machine Images + + + Deploy on managed Kubernetes with full AWS integration + + + + + All deployment options are built on our Kubernetes-native architecture, + ensuring seamless integration with your existing infrastructure. + + +## Key Benefits + + + + Your code and data never leave your infrastructure - maintain full control + over your intellectual property + + + Use your own API keys with AWS Bedrock, Google Vertex AI, and other + providers + + -Coming soon: Deploy Codegen directly from AWS Marketplace with simplified billing and procurement. + Coming soon: Deploy directly from AWS Marketplace with simplified billing and + procurement. -## Deployment Options +## Enterprise Features -### Flexible Infrastructure Support -Codegen on-premises supports a wide range of deployment scenarios, from single-cluster installations to multi-region, high-availability configurations. Our solution is designed to work with your existing security policies, network configurations, and operational procedures. +Enterprise customers receive comprehensive deployment support: -- Private cloud and on-premises Kubernetes clusters -- Air-gapped environments with offline deployment support -- Multi-cluster and multi-region deployments -- Integration with existing CI/CD pipelines and security tools +- **Priority Support** - Dedicated channels and faster response times +- **Custom Configuration** - Tailored deployment plans for your specific requirements +- **Security Integration** - Works with your existing security tools and compliance policies +- **Multi-Region Support** - High-availability configurations across multiple clusters -## Enterprise Only - -On-premises deployment is available exclusively as part of our Enterprise pricing tier. This ensures you receive the dedicated support, custom configuration assistance, and enterprise-grade SLAs necessary for successful on-premises deployments. - -Enterprise customers also receive: -- Priority support -- Custom integrations -- Dedicated customer success management -- Custom deployment plans tailored to your organization's specific requirements + + Air-gapped environments and offline deployments are supported with special + configuration. + ## Getting Started -Ready to deploy Codegen on your own infrastructure? Contact our enterprise team to discuss your requirements and get started with a custom deployment plan. - - - Get in touch with our enterprise team to discuss your on-premises deployment requirements. + + Ready to deploy on your infrastructure? Our enterprise team will create a + custom deployment plan for your organization. -## Security and Compliance - -On-premises deployments maintain the same high security standards as our cloud offering: - -- End-to-end encryption for all data -- Comprehensive audit logging -- Integration with your existing security tools and policies -- Support for compliance requirements (SOC 2, GDPR, etc.) - -## Support - -Our enterprise team has extensive experience with on-premises deployments and can help you navigate the technical and business requirements for your specific use case. - -For technical support and deployment assistance, enterprise customers have access to: -- Dedicated support channels -- Custom deployment documentation -- Direct access to our engineering team -- Regular check-ins and optimization reviews + + Enterprise customers get direct access to our engineering team for deployment + assistance and ongoing optimization reviews. +