Troubleshooting

Missing API key

If you see an error about OPENROUTER_API_KEY:

• Set OPENROUTER_API_KEY in your .env
• Or set ai.apiKey in raiken.config.json

Playwright browsers not installed

If tests fail to launch a browser:

Terminal

npx playwright install

Port already in use

Start Raiken on a different port:

Terminal

raiken start -p 7200

Empty or slow test generation

• Make sure your app is running locally
• Provide a more specific prompt
• Check network access for the model provider

Rebuild local state

If project structure changed significantly:

• Delete .raiken/ and run raiken init again

Example error output

Error Log

ERROR: No API key found. Set OPENROUTER_API_KEY in your environment.
ERROR: Failed to connect to http://localhost:7101 (connection refused).

Status checklist

Check	Status
API key configured	Pending
Dev server running	Pending
Playwright browsers installed	Pending