fixed comments

Author: codegen-bot

docs/blog/act-via-code.mdx

@@ -70,7 +70,7 @@ When an agent writes code, it gains several critical advantages over traditional
 
 ## For Software Engineering
 
-This brings us to software engineering, where we see a massive gap between AI's theoretical capabilities and practical achievements. Many code modification tasks are fundamentally programmatic—dependency analysis, refactors, control flow analysis—yet we lack the tools to express them properly.
+Software engineering tasks are inherently programmatic and graph-based — dependency analysis, refactors, control flow analysis, etc. Yet today's AI agents interface with code primarily through string manipulation, missing the rich structure that developers and their tools rely on. By giving agents APIs that operate on the codebase's underlying graph structure rather than raw text, we can unlock a new tier of capabilities. Imagine agents that can rapidly traverse dependency trees, analyze control flow, and perform complex refactors while maintaining perfect awareness of the codebase's structure.
 
 Consider how a developer thinks about refactoring: it's rarely about direct text manipulation. Instead, we think in terms of high-level operations: "move this function," "rename this variable everywhere," "split this module." These operations can be encoded into a powerful Python API:
 
@@ -81,4 +81,4 @@ for component in codebase.jsx_components:
     if len(component.usages) == 0:
         # powerful edit APIs that handle edge cases
         component.rename(component.name + 'Page')
-```
+```

docs/blog/codemod-frameworks.mdx

@@ -5,6 +5,11 @@ icon: "code-compare"
 iconType: "solid"
 ---
 
+# Others to add
+- [Abracadabra](https://github.com/nicoespeon/abracadabra)
+- [Rope](https://rope.readthedocs.io/en/latest/overview.html#rope-overview)
+- [Grit](https://github.com/getgrit/gritql)
+
 Code transformation tools have evolved significantly over the years, each offering unique approaches to programmatic code manipulation. Let's explore the strengths and limitations of major frameworks in this space.
 
 ## Python's AST Module

docs/introduction/getting-started.mdx

@@ -9,19 +9,18 @@ Follow our step-by-step tutorial to get up and running with Codegen.
 
 ## Installation
 
-We recommend using [`pipx`](https://pypa.github.io/pipx/) to install Codegen globally. `pipx` is a tool to help you install and run Python applications in isolated environments. This isolation ensures that Codegen's dependencies won't conflict with your other Python projects.
+We recommend using [uv](https://github.com/astral-sh/uv) to install Codegen's CLI globally.
 
-First, install `pipx` if you haven't already:
+First, install `uv` if you haven't already:
 
 ```bash
-brew install pipx
-pipx ensurepath  # Ensure pipx binaries are on your PATH
+curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
-Then install Codegen globally:
+Then install Codegen:
 
 ```bash
-pipx install codegen
+uv tool install codegen
 ```
 
 <Note>
@@ -31,7 +30,8 @@ pipx install codegen
 
 ## Quick Start with Jupyter
 
-The fastest way to explore a codebase is using Jupyter. Codegen provides a built-in command to set this up:
+The [codgen notebook](/cli/notebook) command creates a virtual environment and opens a jupyter notebook for quick prototyping. This is often the fastest way to get up and running.
+
 
 ```bash
 # Navigate to your repository

docs/introduction/overview.mdx

@@ -43,7 +43,7 @@ function.set_docstring('new docstring') # set docstring
 ## Installation
 
 ```bash
-pip install codegen
+uv tool install codegen
 ```
 
 ## Get Started

docs/prism.css

@@ -99,9 +99,26 @@ pre[class*="language-"] {
 .dark .prose p code {
 	color: #ffca85 !important;
 }
+.dark .prose p code .comment {
+	color: #6d6d6d !important;
+}
 .dark .prose ul code {
 	color: #ffca85 !important;
 }
+.dark .prose ul code .comment {
+	color: #6d6d6d !important;
+}
+
+/* Comments in code blocks should be gray */
+.token.comment {
+	color: #6d6d6d !important;
+}
+pre .token.comment {
+	color: #6d6d6d !important;
+}
+code .token.comment {
+	color: #6d6d6d !important;
+}
 
 /* links are purple */
 .prose a {
@@ -150,9 +167,6 @@ pre[class*="language-"] {
 .token.property {
 	color: #ffca85 !important;
 }
-.token.comment {
-	color: #6d6d6d !important;
-}
 .token.class-name {
 	color: #82e2ff !important;
 }