diff --git a/README.md b/README.md
index 3490511..afb0a4d 100644
--- a/README.md
+++ b/README.md
@@ -157,6 +157,17 @@ sunbeam check                   # Run all functional probes
 sunbeam check devtools          # Scoped to namespace
 ```
 
+### Coding Agent
+
+```bash
+sunbeam code                    # Terminal coding agent (connects to Sol via gRPC)
+sunbeam code start --model devstral-small  # Override model
+sunbeam code demo               # Demo TUI without Sol connection
+sunbeam reindex-code --org studio          # Index repos into Sol's code search
+```
+
+See [docs/sol-code.md](docs/sol-code.md) for full documentation.
+
 ### Passthrough
 
 ```bash
diff --git a/docs/index.md b/docs/index.md
index 24fe15d..3160cee 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -57,6 +57,7 @@ sunbeam logs ory/kratos
 ## Documentation Structure
 
 - **[CLI Reference](cli-reference)**: Complete command reference
+- **[Sol Code](sol-code)**: Terminal coding agent powered by Sol
 - **[Core Modules](core-modules)**: Detailed module documentation
 - **[Architecture](architecture)**: System architecture and design
 - **[Usage Examples](usage-examples)**: Practical usage scenarios