Having trouble with RepoRose?
Common issues and solutions to get you up and running quickly.
Quick Commands Reference
Initialize Configuration
$reporose initInteractive setup wizard for AI providers and settings.
Analyze Repository
$reporose analyzeScans current directory and generates map.json.
Start Visualization Server
$reporose serveOpens 3D visualization at localhost:8689.
View Configuration
$reporose config --showDisplay current AI provider settings.
'reporose' is not recognized
If you get reporose: command not found after installation, your npm global bin directory is not in your PATH.
Find your npm global path:
$npm config get prefixAdd to PATH (macOS/Linux):
$echo "export PATH=\$(npm config get prefix)/bin:\$PATH" >> ~/.bashrc && source ~/.bashrcUse .zshrc instead of .bashrc if you use Zsh.
Add to PATH (Windows PowerShell):
$$npmPath = npm config get prefix; [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$npmPath", "User")Alternative: Use npx (no PATH needed)
$npx reporose analyzeAI Provider Setup
RepoRose supports multiple AI providers. Choose the one that works best for you:
Ollama (Local - Free)
Run AI locally on your machine. Requires Ollama installed.
$reporose config --model ollama --ollama-model codellama --ollama-url http://localhost:11434Groq (Cloud - Free Tier)
Fast cloud inference with generous free tier.
$reporose config --model groq --api-key-env GROQ_API_KEYSet GROQ_API_KEY environment variable first.
Anthropic Claude
High-quality AI descriptions.
$reporose config --model anthropic --api-key-env ANTHROPIC_API_KEYOpenAI / OpenRouter
Compatible with any OpenAI-compatible API.
$reporose config --model openai --api-key-env OPENAI_API_KEYConfiguration File Location
RepoRose stores configuration in a .reporose directory:
$cat .reporose/config.jsonThe config includes your AI provider, model name, API key environment variable name, and generation parameters.