Introduction

What is ACECode?

ACECode (Az Context Engine) is a self-hosted semantic code indexing and search platform. It gives AI assistants and developers instant access to your entire codebase through natural language queries.

Why ACECode?

Large codebases become hard to navigate. Developers spend hours looking for the right file, understanding how a function is called, or figuring out what changed and why. ACECode solves this by:

Indexing everything — files, chunks, symbols, relationships, git history
Making it queryable — natural language search powered by vector embeddings + BM25
Feeding AI context — works as an MCP server so Claude, Cursor, and other AI tools get precise context

How it works

Index your codebase — The CLI parses your code (TypeScript, Python, Go, Rust, and 15+ languages) and sends semantic chunks to the API.
Vector embeddings — Each chunk is embedded using Voyage AI’s voyage-4 model and stored in PostgreSQL with pgvector.
Hybrid search — Queries combine vector similarity (semantic) with BM25 full-text search, then rerank with AI for precision.
Serve context — Results are served via REST API or MCP protocol to any compatible client.

Key features

Semantic Search

Query your codebase in plain English. “Find the authentication middleware” returns the right file instantly.

AI Memories

Automatically detects patterns, conventions, and architectural decisions from your code.

Code Graph

Understand dependencies, blast radius of changes, and call chains across your entire codebase.

MCP Protocol

Native MCP server — plug into Claude, Cursor, or any AI assistant for grounded, accurate responses.

Architecture

ACECode runs as a self-hosted API on your infrastructure:

CLI (local)  →  REST API  →  PostgreSQL + pgvector
                    ↑              ↓
              MCP Server    Voyage AI (embeddings)
                    ↑
              AI Assistant

Your code never leaves your infrastructure unless you explicitly connect to external AI services.