Getting Started
Quick Setup
1. Install Constellation CLI
npm install -g @constellationdev/cli@latest
2. Authenticate
Get your Constellation access key and configure your system:
constellation auth
This will persist your credential on your local system for future use.
3. Initialize Your Project
Initialize Constellation in your current project:
constellation init
This will prompt you for the project details; Constellation project ID, supported languages, and AI tools which to configure with the Constellation MCP.
4. Index Your Codebase
Build the initial index of your code:
constellation index
This command parses your code locally, generates source code metadata, and streams it to the Constellation service. Run this whenever you want to update the index, it intelligently performs incremental indexing to keep things fast, only processing changed files.
Next Steps
With all three components working together, your AI coding assistant can now intelligently search, understand, and work with your entire codebase. Check out the CLI documentation and MCP Server documentation for more details.
Constellation Components
The system consists of three primary components which work together harmoniously:
☁️ Constellation Service
The cloud service that provides advanced codebase intelligence extraction, graph storage, and intelligent analysis. This is where your codebase knowledge graphs are processed, stored, and shared across your entire team. The service performs all intelligence extraction server-side using only source code metadata, ensuring consistent and powerful analysis without ever receiving raw source code.
⚙️ CLI Tool
A command-line tool that parses your source code locally and transmits only source code metadata to the Constellation service. Your source code never leaves your local environment - only structural metadata is transmitted. The CLI uses efficient NDJSON streaming to handle codebases of any size and supports both full and incremental indexing.
Learn more about the CLI Tool →
🧩 MCP Server
A Model Context Protocol STDIO server that bridges your AI coding assistant to the Constellation service. It provides powerful code intelligence tools that enable your AI assistant to search symbols, analyze dependencies, trace usage, detect patterns, and understand your codebase architecture - all powered by the team's shared knowledge graph.