Stellarion is designed to work seamlessly with Claude Code, Anthropic's CLI for AI-assisted development.
npm install -g stellarion
cd /path/to/your/project
stellarion init
This configures Claude Code to use Stellarion's MCP server.
Start Claude Code and check that Stellarion tools are available:
claude
Ask Claude:
What Stellarion tools are available?
Analyze the code quality of this project.
What are the main issues I should address?
Claude Code will use Stellarion's analyze_quality and find_refactoring tools to provide a comprehensive assessment.
Help me understand this codebase.
What's the overall structure and main components?
Claude Code will use project_info and analyze_structure to explain the architecture.
Find the authentication middleware in this project.
Claude Code will use search_semantic to locate relevant code by meaning.
I want to refactor src/services/userService.ts.
What would be affected?
Claude Code will use analyze_impact to assess the risk and scope of changes.
Generate a technical debt report for this project.
Claude Code will use generate_report to create a comprehensive analysis.
For best semantic search results, index your project:
Index this project for semantic search
The more context you provide, the better the analysis:
Analyze the complexity of the API routes in src/api/
Check the code quality
Ask Claude to use multiple tools together:
Find the most complex functions in src/,
show their dependencies,
and suggest refactoring priorities.
Use follow-up questions to drill down:
> Analyze code quality in src/
[Results]
> Show me more details about the userService complexity
[Details]
> What would be affected if I split this into smaller functions?
[Impact analysis]
Stellarion configuration is stored in .stellarion/ in your project:
.stellarion/
├── .env # Environment variables
└── config.json # Project settings
Configure in .stellarion/.env:
OPENAI_API_KEY=sk-your-key
ROBERTA_MODEL_PATH=/path/to/models