tessera-codegraph 0.8.0

A local, deterministic semantic code graph and MCP server for AI coding agents. 11 languages, personalized PageRank impact, hallucination validator, call-path tracing, graph export, incremental indexing.
Documentation 
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

# Integrations

Tessera speaks **MCP** (Model Context Protocol). Any agent that supports MCP can call its tools. Index once per repo (or via a post-clone hook), then point your agent at the binary.

```sh
cd path/to/your/repo
tessera index .
```

**Exposed tools** (all of them, in every client below): `find_definition` · `find_references` · `get_outline` · `expand_symbol` · `impact` · `connect` · `export` · `context_pack` · `plan_query` · `edit_prep` · `diff_impact` · `imports` · `imported_by` · `signature` · `siblings` · `search` · `unused` · `validate` · `validate_snippet` · `tests_for` · `stats`. Schemas in [mcp.md](mcp.md).

## Claude Code

Either edit `~/.claude.json` directly, or run from your repo root:

```sh
claude mcp add tessera tessera -- mcp --db .tessera/tessera.db
```

Restart Claude Code; the tools appear as `mcp__tessera__*`. Confirm with `/mcp` in the session.

## Cursor

Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):

```json
{
  "mcpServers": {
    "tessera": {
      "command": "tessera",
      "args": ["mcp", "--db", "${workspaceFolder}/.tessera/tessera.db"]
    }
  }
}
```

Reload the window. Tessera shows up under **Settings → MCP**.

## Cline (VS Code)

Open the Cline panel → `…` menu → **MCP Servers** → **Configure MCP Servers**, then add:

```json
{
  "mcpServers": {
    "tessera": {
      "command": "tessera",
      "args": ["mcp", "--db", ".tessera/tessera.db"],
      "disabled": false,
      "autoApprove": ["find_definition", "find_references", "get_outline", "search", "validate"]
    }
  }
}
```

The `autoApprove` list is optional — those are the read-only queries safe to run without a prompt.

## Continue.dev (VS Code / JetBrains)

In `~/.continue/config.json` (or workspace `.continue/config.json`):

```json
{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "tessera",
          "args": ["mcp", "--db", ".tessera/tessera.db"]
        }
      }
    ]
  }
}
```

## Codex CLI (OpenAI)

In `~/.codex/config.toml`:

```toml
[[mcp_servers]]
name = "tessera"
command = "tessera"
args = ["mcp", "--db", ".tessera/tessera.db"]
```

## Zed

In `~/.config/zed/settings.json`:

```json
{
  "context_servers": {
    "tessera": {
      "command": {
        "path": "tessera",
        "args": ["mcp", "--db", ".tessera/tessera.db"]
      }
    }
  }
}
```

## Aider

Aider doesn't speak MCP yet, but you can drop Tessera into its shell-out workflow:

```sh
aider --read-only-cmd "tessera get-outline {file}" \
      --pre-prompt "Use \`tessera impact {symbol}\` before editing any function."
```

For richer integration, point Aider at `tessera search` and `tessera impact` from its `/run` hook.

## GPT / ChatGPT (custom GPTs, no MCP)

Build a simple wrapper that exposes the CLI as HTTP — e.g. `tessera mcp` behind a stdio→HTTP shim like [`mcp-proxy`](https://github.com/sparfenyuk/mcp-proxy) — and register it as a custom GPT action. The tool schemas in [mcp.md](mcp.md) map 1:1 to OpenAPI function specs.

## Custom / library

Any process can spawn `tessera mcp --db <path>` and talk JSON-RPC over stdio. Or skip MCP entirely and use the [Rust library](../README.md#use-as-a-rust-library) — `Index::open(...).impact(...)` is exactly the same query path the MCP server uses.

For local clients that need HTTP instead of stdio, run:

```sh
tessera mcp-http --addr 127.0.0.1:8765 --db .tessera/tessera.db
```

The HTTP transport exposes `POST /mcp` for JSON-RPC, `GET /sse` as a simple
readiness event stream, and `GET /health` for health checks.

## Tip: re-index after pulls

Add this to a git hook (`.git/hooks/post-merge`, `post-checkout`):

```sh
tessera index .   # incremental by default — sha-diff skips unchanged files
```

A 950-file Java repo with one changed file re-indexes in ~70 ms.