/

Engineering

How Axon indexes your codebase

A technical deep-dive into how Axon indexes your codebase, why it's fast, and what it means for suggestion quality.

A man wearing glasses and a dark sweater smiles at the camera against a neutral background.

Marcus Reid

CTO & Co-founder

How we index your codebase

When you first open a project with Axon, it does something most AI coding tools don't: it reads your entire codebase.

Not just the files you have open. Not just recently edited files. Everything.

This is called codebase indexing, and it's the foundation of everything Axon does well.

What indexing actually does

Indexing creates a semantic map of your codebase. Axon parses every file, extracts the structure — functions, types, exports, imports, call graphs — and builds a representation that it can query in real time as you type.

This is different from just storing files. Axon understands relationships. It knows that getUserProfile calls fetchUser, which depends on validateSession. When you're writing code that touches the auth system, Axon can surface relevant context from across your entire codebase in milliseconds.

Why it's fast

The first index takes a few seconds on most codebases. After that, Axon maintains an incremental index — only re-indexing files that have changed. This means the index is always up to date without any noticeable performance impact.

We've optimized the indexing pipeline significantly over the past year. What used to take 30 seconds on a 100k-line codebase now takes under 5.

Privacy

Your code never leaves your machine during indexing. The index is built and stored locally. When Axon needs to make a suggestion, it sends only the relevant context to the model — never your entire codebase.

This is a hard constraint we've built around from the beginning. Your code is yours.

More posts

Keep reading about

Engineering

Engineering

Engineering

More thoughts from the Axon team.

Why we built Axon

Company

The story behind Axon — why we started it, what we got wrong early on, and what we're building toward.

How Axon indexes your codebase

Engineering

A technical deep-dive into how Axon indexes your codebase, why it's fast, and what it means for suggestion quality.

Designing Axon's editor UI

Design

The design decisions behind Axon's editor UI — why we chose inline over popups, how we think about color, and what we're still figuring out.

Why we built Axon

Company

The story behind Axon — why we started it, what we got wrong early on, and what we're building toward.

How Axon indexes your codebase

Engineering

A technical deep-dive into how Axon indexes your codebase, why it's fast, and what it means for suggestion quality.

Start writing better code today

Join 10,000+ developers shipping faster with Axon.

Start writing better code today

Join 10,000+ developers shipping faster with Axon.

Start writing better code today

Join 10,000+ developers shipping faster with Axon.

Create a free website with Framer, the website builder loved by startups, designers and agencies.