>_CONSTELLATION://HOW_IT_WORKS

How Constellation Works

A plain-language overview of indexing, language support, MCP clients, and the security model.

Overview

The Constellation CLI parses your codebase locally, extracts its structural shape (functions, classes, types, imports, and how they relate), and uploads that metadata to build a shared code intelligence graph. AI coding assistants query the graph through an MCP (Model Context Protocol) server to get precise, instant answers instead of grepping through files.

Language Support

Constellation currently parses and indexes:

Language	File Extensions
TypeScript	.ts, .tsx
JavaScript	.js, .jsx
Python	.py, .pyi
Go	.go
C#	.cs

Additional languages are added over time; check the docs for the current list.

Supported MCP Clients

Constellation works with any AI coding tool that speaks MCP. The CLI's init command can write the server configuration directly into these clients:

Claude Code
Antigravity CLI
Cline
Codex CLI
Copilot CLI
Cursor
JetBrains
Kilo Code
OpenCode
Tabnine
VSCode

Security Model: Your Source Code Never Leaves Your Machine

Parsing happens entirely on your machine. Only structural metadata (symbol names, type signatures, file paths, and import/export relationships) is uploaded, compressed and encrypted in transit. Function bodies, comments, string literals, and implementation logic are never transmitted.

We see the shape of your code. We never see the substance.

Install

Install the CLI globally:

npm install -g @constellationdev/cli@latest

Initialize your project (creates constellation.json and offers to configure your MCP client):

constellation init

Authenticate with your Constellation access key:

constellation auth

Index your codebase:

constellation index

Full command reference and CI/CD setup: docs.constellationdev.io.

← Return to Constellation