Name: Claude Dojo
Author: Rahul Subramaniam

Configuration File

Claude Dojo looks for configuration in the following locations (in order):

.claude-dojo.json in the current directory
.claude-dojo.json in your home directory
Environment variables

Configuration Options

API Settings

{
  "apiKey": "your-api-key",
  "model": "claude-sonnet-4-20250514",
  "maxTokens": 4096
}

Option	Description	Default
`apiKey`	Your Anthropic API key	-
`model`	Claude model to use	`claude-sonnet-4-20250514`
`maxTokens`	Maximum response tokens	`4096`

Server Settings

{
  "port": 3001,
  "host": "localhost",
  "openBrowser": true
}

Option	Description	Default
`port`	Server port	`3001`
`host`	Server host	`localhost`
`openBrowser`	Auto-open browser	`true`

Interface Settings

{
  "theme": "dark",
  "hexGridSize": "medium",
  "showContextBar": true
}

Option	Description	Default
`theme`	Color theme (`dark`/`light`)	`dark`
`hexGridSize`	Grid density	`medium`
`showContextBar`	Show token usage	`true`

Permission Settings

{
  "permissions": {
    "autoApproveRead": true,
    "autoApproveWrite": false,
    "autoApproveShell": false,
    "allowedPaths": ["/home/user/projects"],
    "blockedPaths": ["/etc", "/root"]
  }
}

Option	Description	Default
`autoApproveRead`	Auto-approve file reads	`true`
`autoApproveWrite`	Auto-approve file writes	`false`
`autoApproveShell`	Auto-approve shell commands	`false`
`allowedPaths`	Whitelisted paths	`[]`
`blockedPaths`	Blacklisted paths	`[]`

Environment Variables

All configuration options can be set via environment variables:

export CLAUDE_DOJO_API_KEY=your-api-key
export CLAUDE_DOJO_PORT=3002
export CLAUDE_DOJO_MODEL=claude-sonnet-4-20250514

Command Line Arguments

Override any setting via command line:

claude-dojo --port 3002 --model claude-sonnet-4-20250514

Run claude-dojo --help for all available options.