Installation

Stellarion runs as a single binary serving both VS Code (LSP) and AI clients (MCP). Choose the installation method that matches your workflow.

VS Code Extension (Recommended)

The easiest way to get started. Install directly from the VS Code Marketplace:

1. Open the Stellarion extension page
2. Click Install
3. Reload VS Code

Or install from the command line:

code --install-extension Stellarion.stellarion

Or search for "Stellarion" in the VS Code Extensions panel (Ctrl+Shift+X / Cmd+Shift+X).

The extension bundles the server binary for all platforms (macOS ARM/x64, Linux x64, Windows x64) — no additional setup needed. All 47 tools are registered as Language Model Tools for Copilot and other AI assistants.

VS Code Settings

Configure in .vscode/settings.json or VS Code Settings UI:

{
  "stellarion.indexOnStartup": true,
  "stellarion.indexPaths": ["/path/to/project-a", "/path/to/project-b"],
  "stellarion.excludePatterns": ["**/build/**", "**/generated/**"],
  "stellarion.embeddingModel": "bge-small",
  "stellarion.maxFileSizeKB": 1024,
  "stellarion.maxFiles": 5000,
  "stellarion.mode": "general",
  "stellarion.debug": false
}

EDA mode — set stellarion.mode: "eda" to filter the tool surface for Quartus / Qsys / SDC workflows. Hides tools that don't apply to HDL/Tcl (scan_security, find_implementors, find_related_tests, cross_project_search) and surfaces the three EDA-native Pro tools. EDA and hybrid modes require a Pro license or active 180-day trial. See the EDA Mode guide.

MCP Server (Claude Code, Cursor, Windsurf)

For AI-native workflows with Claude Code, Cursor, or any MCP client.

Option 1: npm (Recommended for MCP)

npm install -g @stellarion/stellarion-mcp

Then add to your MCP client config:

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "stellarion": {
      "command": "stellarion-mcp",
      "args": []
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "stellarion": {
      "command": "stellarion-mcp",
      "args": []
    }
  }
}

Option 2: Direct Binary

Download the binary for your platform from GitHub Releases and add to your MCP config:

{
  "mcpServers": {
    "stellarion": {
      "command": "/path/to/stellarion-server",
      "args": ["--mcp"]
    }
  }
}

MCP Server Options

EDA Mode Example

{
  "mcpServers": {
    "stellarion": {
      "command": "stellarion-mcp",
      "args": [
        "--workspace", "/path/to/quartus-project",
        "--mode", "eda"
      ]
    }
  }
}

Multi-Project Example

{
  "mcpServers": {
    "stellarion": {
      "command": "stellarion-mcp",
      "args": [
        "--workspace", "/path/to/frontend",
        "--workspace", "/path/to/backend",
        "--exclude", "node_modules",
        "--exclude", "dist"
      ]
    }
  }
}

Verify Installation

VS Code

Open the command palette (Ctrl+Shift+P / Cmd+Shift+P) and type "Stellarion". You should see Stellarion commands listed.

MCP Server

stellarion-server --info

Expected output:

stellarion-server v2.0.0
Author: Stellarion <info@stellarion.ai>
License: Proprietary
Repository: https://github.com/stellarion-ai/stellarion

Platform Support

Requirements

• VS Code: 1.90 or higher
• Node.js: 18+ (for npm installation only)
• No other dependencies — the server is a self-contained Rust binary

Next Steps

Continue to the Quick Start guide to run your first analysis.