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
Install the package:
```sh
npm install -g tessera-codegraph
cargo install tessera-codegraph
```
Index a repository:
```sh
cd path/to/project
tessera init --mcp-configs
tessera index .
tessera doctor
```
Re-running `tessera index .` reuses unchanged files via sha-diff. Use `--full` to rebuild from scratch.
Run `tessera watch .` while editing to keep the index fresh automatically.
Ask graph questions:
```sh
tessera find-definition findById
tessera find-references findById
tessera get-outline src
tessera expand-symbol findById
tessera impact findById
tessera watch . --poll-ms 500
tessera validate findByIdd
tessera tests-for findById
tessera stats
tessera doctor --json
tessera completions bash
tessera mcp-http --addr 127.0.0.1:8765
tessera search '*Repository*' --kind class --language java
tessera search parseFrom --language java
tessera search 'init*' --kind method --exported
tessera unused --kind function --exported=false
tessera context-pack findById --budget 1500
tessera plan-query "edit findById safely" --symbol findById
tessera edit-prep findById --budget 1800
tessera diff-impact origin/main
tessera export --from findById --group-by directory --html-out graph.html
tessera imports src/users.ts
tessera imported-by ./users
tessera signature UserService
tessera siblings findById
```
Validate a snippet (stdin):
```sh
Use JSON output for scripts or agents:
```sh
tessera impact findById --json
```
The v0.5 JSON response schema snapshot lives in
[`docs/json-schemas/tessera-cli-v0.5.schema.json`](json-schemas/tessera-cli-v0.5.schema.json).
For include/exclude rules in larger repos, see [`docs/configuration.md`](configuration.md).
Use a custom database path:
```sh
tessera index . --db /tmp/project.tessera.db
tessera get-outline src --db /tmp/project.tessera.db
```
Generate the perf chart used in the README:
```sh
tessera bench --path examples/sample
tessera bench --out docs/benchmarks.md # write the chart to disk
```
Rebuild the memory-mapped snapshot manually:
```sh
tessera snapshot
```
Try the bundled sample:
```sh
tessera index examples/sample --db /tmp/tessera-sample.db
tessera find-definition findById --db /tmp/tessera-sample.db
tessera impact findById --db /tmp/tessera-sample.db
```