indxr 0.2.0

Fast codebase indexer for AI agents
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

# Git-Aware Structural Diffing

indxr can show what changed structurally since any git ref — not line-level diffs, but declaration-level changes: which functions, structs, classes, and methods were added, removed, or had their signatures modified.

## Usage

```bash
indxr --since <REF>
```

Where `<REF>` is any valid git reference:

```bash
# Since a branch
indxr --since main
indxr --since develop

# Since a tag
indxr --since v1.0.0
indxr --since release-2025.03

# Since a relative commit
indxr --since HEAD~3
indxr --since HEAD~10

# Since a specific commit
indxr --since abc1234
```

## Output Format

### Markdown

```markdown
# Structural Changes (since main)

## Added Files
- src/new_module.rs

## Removed Files
- src/old_module.rs

## Modified Files

### src/parser/mod.rs
+ `pub fn new_parser() -> Parser`
- `fn old_helper()`
~ `fn process(x: i32)` -> `fn process(x: i32, y: i32)`

### src/model/declarations.rs
+ `pub struct Metadata`
+ `pub fn Metadata::is_empty(&self) -> bool`
~ `pub enum DeclKind` (variants changed)
```

**Markers:**
- `+` — Declaration added
- `-` — Declaration removed
- `~` — Declaration modified (signature changed)

### JSON

```bash
indxr --since main -f json
```

```json
{
  "since_ref": "main",
  "files_added": ["src/new_module.rs"],
  "files_removed": ["src/old_module.rs"],
  "files_modified": [
    {
      "path": "src/parser/mod.rs",
      "declarations_added": [
        { "kind": "Function", "name": "new_parser", "signature": "pub fn new_parser() -> Parser" }
      ],
      "declarations_removed": [
        { "kind": "Function", "name": "old_helper", "signature": "fn old_helper()" }
      ],
      "declarations_modified": [
        {
          "kind": "Function",
          "name": "process",
          "old_signature": "fn process(x: i32)",
          "new_signature": "fn process(x: i32, y: i32)"
        }
      ]
    }
  ]
}
```

## How It Works

1. **Identify changed files** using `git diff --name-only <ref>...HEAD`
2. **Retrieve old file content** using `git show <ref>:<path>` for each changed file
3. **Parse both versions** — current files from disk, old files from git
4. **Compare declarations** — match by name and kind, detect additions, removals, and signature changes
5. **Output the structural diff** in the selected format

## Combining with Other Options

Filters and output options work with `--since`:

```bash
# Only show structural changes in Rust files
indxr --since main -l rust

# Only changes in a specific directory
indxr --since main --filter-path src/parser

# JSON output for programmatic use
indxr --since v1.0.0 -f json -o changes.json

# Only public API changes
indxr --since main --public-only
```

## Use Cases

### Code Review Preparation

Before reviewing a branch, see what changed structurally:

```bash
indxr --since main --public-only
```

This shows API surface changes without the noise of implementation details.

### Release Notes

Compare against the last release tag to see all structural changes:

```bash
indxr --since v1.2.0
```

### Agent Context for Recent Changes

Give an AI agent context about what changed recently:

```bash
indxr --since HEAD~5 --max-tokens 4000
```

### Monitoring API Stability

Track public API changes between versions:

```bash
indxr --since v1.0.0 --public-only -f json -o api-changes.json
```