Stellarion
Getting Started

Licensing

Stellarion Community and Pro licensing

Stellarion uses a simple two-tier model: Community (free, open source) and Pro (license key).

Community Edition

All 28 community tools are free to use. No license key needed. This includes:

  • Code analysis (AI context, complexity, impact, call graphs, dependencies)
  • Search and navigation (symbol search, callers/callees, imports, signatures)
  • Persistent memory (7 tools for cross-session knowledge)
  • Indexing (workspace, files, directories)

Pro Edition

16 additional tools for architects and team leads. Requires a license key.

Included in Pro:

  • Codebase health dashboard
  • Tech debt reports
  • Change risk assessment
  • Coupling analysis
  • Dependency drift detection
  • API surface reports
  • Security scanning
  • Dead code detection
  • Code similarity (duplicates, clustering, comparison)
  • Git history mining and semantic search

180-Day Free Trial

A free trial starts automatically when you first run Stellarion. All Pro tools are available for 180 days with no signup and no credit card.

Getting a License

Purchase a Pro license at stellarion.ai/pro.

Installing Your License Key

Save your license key to ~/.stellarion/license.key:

macOS / Linux:

mkdir -p ~/.stellarion
echo "YOUR_LICENSE_KEY" > ~/.stellarion/license.key

Windows (PowerShell):

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.stellarion"
"YOUR_LICENSE_KEY" | Out-File -FilePath "$env:USERPROFILE\.stellarion\license.key" -Encoding UTF8

You can also set the license via environment variable:

export STELLARION_LICENSE=/path/to/license.key

VS Code Extension

In VS Code, use the command palette: Stellarion: Activate License and paste your key.

Verifying Your License

stellarion-server --info

Output shows your edition and license status:

stellarion-server v2.0.0
Author: Stellarion <info@stellarion.ai>
License: Proprietary
Edition: pro (Acme Corp, expires 2027-01-01)

How Pro Tools Work

All 44 tools are always visible — Pro tools are marked with Pro in their descriptions. When you invoke a Pro tool:

  • With valid license: tool executes normally
  • Trial active: tool executes normally (180-day window)
  • No license / expired: tool returns a message with a link to purchase

Pro tools never disappear from the tool list. AI agents can discover them and understand what's available.

License Key Format

License keys are base64-encoded JSON payloads:

{
  "org": "Acme Corp",
  "email": "dev@acme.com",
  "seats": 10,
  "expires": "2027-01-01",
  "features": ["all"],
  "tier": "pro"
}

Features

Licenses can grant specific feature sets or all features:

FeatureTools Included
securityscan_security
couplinganalyze_coupling, codebase_health, tech_debt_report, assess_change_risk, dependency_drift, api_surface
unused_codefind_unused_code
similarityfind_duplicates, find_similar, cluster_symbols, compare_symbols
cross_projectcross_project_search
git_miningmine_git_history, mine_git_history_for_file, search_git_history
allAll Pro tools

Offline-First

All license validation happens locally. No phone-home, no internet required. The license key contains all the information needed for validation.

License File Location

PlatformPath
macOS / Linux~/.stellarion/license.key
Windows%USERPROFILE%\.stellarion\license.key

Need Help?