Configuration

Raiken is configured with raiken.config.json. This file is created by raiken init and can be edited at any time.

Full configuration

{
  "projectType": "generic",
  "testDirectory": "tests",
  "playwrightConfig": "playwright.config.ts",
  "outputFormats": ["typescript"],
  "storageStatePath": null,
  "ai": {
    "provider": "openrouter",
    "model": "anthropic/claude-3.5-sonnet",
    "apiKey": null
  },
  "features": {
    "video": true,
    "screenshots": true,
    "tracing": false,
    "network": true
  },
  "browser": {
    "defaultBrowser": "chromium",
    "headless": true,
    "timeout": 30000,
    "retries": 1
  }
}

Minimal config

Most fields have sensible defaults. A minimal config looks like:

{
  "projectType": "generic",
  "testDirectory": "tests"
}

Field reference

Project settings

Field	Default	Description
`projectType`	`"generic"`	Project preset (`generic`, `nextjs`, `react`, `vue`)
`testDirectory`	`"tests"`	Where generated tests are saved
`playwrightConfig`	`"playwright.config.ts"`	Path to Playwright config
`outputFormats`	`["typescript"]`	Generated file types
`storageStatePath`	`null`	Path to Playwright storage state for auth

AI settings

Field	Default	Description
`ai.provider`	`"openrouter"`	AI provider
`ai.model`	`"anthropic/claude-3.5-sonnet"`	Model identifier
`ai.apiKey`	`null`	API key (prefer env var instead)

Feature flags

Field	Default	Description
`features.video`	`true`	Record video during test runs
`features.screenshots`	`true`	Capture screenshots on failure
`features.tracing`	`false`	Enable Playwright tracing
`features.network`	`true`	Log network requests

Browser settings

Field	Default	Description
`browser.defaultBrowser`	`"chromium"`	Browser to use (`chromium`, `firefox`, `webkit`)
`browser.headless`	`true`	Run browser in headless mode
`browser.timeout`	`30000`	Default timeout in milliseconds
`browser.retries`	`1`	Number of test retries

Environment variables

Set your API key in .env rather than the config file:

# Required - AI Provider API Key
OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Optional - Override model
OPENROUTER_MODEL=anthropic/claude-sonnet-4.5

# Optional - Custom base URL
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1

Environment variables take precedence over config file values.

Local workspace

Raiken creates a .raiken/ directory containing:

raiken.db — SQLite database with code graph and embeddings
cache/ — Analysis cache

Add this to your .gitignore:

.raiken/

Test artifacts

Raiken also creates:

test-results/ — Playwright artifacts (videos, screenshots, traces)
test-reports/ — Raiken JSON output

Authenticated sessions

For apps that require login, capture a Playwright storage state and reference it:

{
  "storageStatePath": ".raiken/auth.json"
}

See Playwright’s authentication docs for how to generate storage state.