Global Configuration

Create ~/.roborev/config.toml to set system-wide defaults.

Example Configuration

default_agent = "codex"
server_addr = "127.0.0.1:7373"
max_workers = 4
job_timeout = "10m"  # Per-job timeout (default: 10m)

Options

Option	Type	Default	Description	Hot-Reload
`default_agent`	string	auto-detect	Default AI agent to use	Yes
`server_addr`	string	127.0.0.1:7373	Daemon listen address	No
`max_workers`	int	4	Number of parallel review workers	No
`job_timeout`	duration	10m	Per-job timeout	Yes
`allow_unsafe_agents`	bool	false	Enable agentic mode globally	Yes
`anthropic_api_key`	string	-	Anthropic API key for Claude Code	Yes
`review_context_count`	int	3	Recent reviews to include as context	Yes

Hot-Reload

The daemon automatically watches ~/.roborev/config.toml for changes. When you edit the file, most settings take effect immediately without restarting the daemon.

Settings that hot-reload:

default_agent
job_timeout
allow_unsafe_agents
anthropic_api_key
review_context_count

Settings that require daemon restart:

server_addr (the daemon listen address)
max_workers (worker pool size is set at startup)
[sync] section (PostgreSQL sync configuration)

When a configuration change is detected, you’ll see a “Config reloaded” notification in the TUI that displays for 5 seconds.

Data Directory

All roborev data is stored in ~/.roborev/ by default:

~/.roborev/
├── config.toml    # Global configuration
├── daemon.json    # Runtime state (port, PID)
└── reviews.db     # SQLite database

Override with the ROBOREV_DATA_DIR environment variable:

export ROBOREV_DATA_DIR=/custom/path

Worker Pool

The max_workers setting controls how many reviews can run in parallel. Increase for faster throughput on multi-core machines:

max_workers = 8

Job Timeout

The job_timeout setting controls how long a single review job can run before being killed:

job_timeout = "15m"  # 15 minutes

Agentic Mode

Enable agentic mode globally (allows agents to edit files and run commands):

allow_unsafe_agents = true