docs: update CLI documentation for unified indexing

- Update README with dev git commands
- Update cli.mdx with new dev index options and dev git subcommands
- Update examples with unified indexing

Author: prosdev

README.md

@@ -197,15 +197,20 @@ npm link
 ## CLI Commands
 
 ```bash
-# Index repository
+# Index everything (code, git history, GitHub)
 dev index .
+dev index . --no-github               # Skip GitHub indexing
 
 # Semantic search
 dev search "how do agents communicate"
 dev search "error handling" --threshold 0.3
 
+# Git history search
+dev git search "authentication fix"   # Semantic search over commits
+dev git stats                         # Show indexed commit count
+
 # GitHub integration
-dev gh index                          # Index issues and PRs
+dev gh index                          # Index issues and PRs (also done by dev index)
 dev gh search "authentication bug"    # Semantic search
 
 # View statistics

examples/README.md

@@ -8,7 +8,7 @@ Real-world usage patterns for dev-agent MCP tools.
 # Install dev-agent
 npm install -g dev-agent
 
-# Index your repository
+# Index your repository (code, git history, GitHub)
 cd /path/to/your/project
 dev index .
 
@@ -350,9 +350,15 @@ dev_health
 ## CLI Examples
 
 ```bash
-# Search from command line
+# Index everything
+dev index .
+
+# Search code
 dev search "authentication" --limit 5 --threshold 0.4
 
+# Search git history
+dev git search "authentication fix"
+
 # Check stats
 dev stats
 

website/content/docs/cli.mdx

@@ -22,18 +22,28 @@ Creates a `.dev-agent.json` configuration file with default settings.
 
 ### `dev index`
 
-Index your repository for semantic search.
+Index your repository for semantic search. Indexes code, git history, and GitHub issues/PRs.
 
 ```bash
 dev index .
 dev index /path/to/repo
 ```
 
+**What gets indexed:**
+- ✅ Code (always)
+- ✅ Git history (if in a git repo)
+- ✅ GitHub issues/PRs (if gh CLI installed and authenticated)
+
+Shows an upfront "indexing plan" before starting.
+
 **Options:**
 | Flag | Description |
 |------|-------------|
 | `-f, --force` | Force re-index even if unchanged |
 | `-v, --verbose` | Show verbose output |
+| `--no-git` | Skip git history indexing |
+| `--no-github` | Skip GitHub issues/PRs indexing |
+| `--git-limit <n>` | Max git commits to index (default: 500) |
 
 ### `dev search`
 
@@ -95,13 +105,52 @@ dev plan 42 --include-comments --include-history
 Index and search GitHub issues/PRs.
 
 ```bash
-# Index GitHub metadata
+# Index GitHub metadata (also done by dev index)
 dev gh index
 
 # Search issues/PRs
 dev gh search "authentication bug"
+
+# Get context for an issue
+dev gh context --issue 42
+```
+
+### `dev git`
+
+Index and search git commit history.
+
+```bash
+# Index git history (also done by dev index)
+dev git index
+dev git index --limit 1000 --since "6 months ago"
+
+# Semantic search over commits
+dev git search "authentication fix"
+dev git search "bug fix" --limit 5
+
+# Show indexed commit stats
+dev git stats
 ```
 
+**Subcommands:**
+| Command | Description |
+|---------|-------------|
+| `dev git index` | Index git commit history |
+| `dev git search <query>` | Semantic search over commits |
+| `dev git stats` | Show indexed commit count |
+
+**Index Options:**
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--limit <n>` | Max commits to index | 500 |
+| `--since <date>` | Only index commits after date | - |
+
+**Search Options:**
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--limit <n>` | Max results | 10 |
+| `--json` | Output as JSON | false |
+
 ### `dev update`
 
 Incrementally update the index with changed files.
@@ -245,13 +294,15 @@ The `.dev-agent.json` file configures the indexer:
 ### Basic Workflow
 
 ```bash
-# Initialize and index
-dev init
+# Index everything (code, git history, GitHub)
 dev index .
 
 # Search for code
 dev search "user authentication"
 
+# Search git history
+dev git search "authentication fix"
+
 # View statistics
 dev stats
 ```