Stellarion uses a simple two-tier model: Community (free, open source) and Pro (license key).
All 28 community tools are free to use. No license key needed. This includes:
16 additional tools for architects and team leads. Requires a license key.
Included in Pro:
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.
Purchase a Pro license at stellarion.ai/pro.
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
In VS Code, use the command palette: Stellarion: Activate License and paste your key.
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)
All 44 tools are always visible — Pro tools are marked with Pro in their descriptions. When you invoke a Pro tool:
Pro tools never disappear from the tool list. AI agents can discover them and understand what's available.
License keys are base64-encoded JSON payloads:
{
"org": "Acme Corp",
"email": "dev@acme.com",
"seats": 10,
"expires": "2027-01-01",
"features": ["all"],
"tier": "pro"
}
Licenses can grant specific feature sets or all features:
| Feature | Tools Included |
|---|---|
security | scan_security |
coupling | analyze_coupling, codebase_health, tech_debt_report, assess_change_risk, dependency_drift, api_surface |
unused_code | find_unused_code |
similarity | find_duplicates, find_similar, cluster_symbols, compare_symbols |
cross_project | cross_project_search |
git_mining | mine_git_history, mine_git_history_for_file, search_git_history |
all | All Pro tools |
All license validation happens locally. No phone-home, no internet required. The license key contains all the information needed for validation.
| Platform | Path |
|---|---|
| macOS / Linux | ~/.stellarion/license.key |
| Windows | %USERPROFILE%\.stellarion\license.key |