Settings

Overview

The Flaio CLI stores configuration in a local JSON file. You can modify settings via the CLI or by editing the file directly.

Configuration File

~/.config/flaio/settings.json

The file has 0600 permissions (user read/write only). If you have a legacy config at ~/.config/agent-manager/, it will be auto-migrated.

Viewing Settings

flaio settings

Displays all settings as formatted JSON with auth tokens masked.

Modifying Settings

flaio settings set <key> <value>

Use dot notation for nested keys. Values are auto-parsed (true/false → boolean, numbers → number, null → null).

Available Settings

UI (ui.*)

Setting	Description	Default
ui.sidebarWidth	Sidebar width in columns	24
ui.narrowBreakpoint	Compact mode breakpoint (columns)	100
ui.targetFps	Screen render FPS	30
ui.showCost	Display session cost	false

Agents (agents.*)

Setting	Description	Default
agents.statusCheckInterval	Status poll interval (ms)	1000
agents.detectorInterval	Standalone agent scan interval (ms)	5000

Relay (relay.*)

Setting	Description	Default
relay.enabled	Enable remote access	false
relay.autoConnect	Auto-connect on startup	true
relay.defaultShareMode	Share mode (read-only or read-write)	read-write
relay.maxReplayBufferKB	Scrollback buffer size (KB)	100
relay.e2eEncryption	End-to-end encryption	true
relay.relayUrl	Relay server URL	wss://api.flaio.ai

Connectors (connectors.*)

See Integrations for connector-specific settings.

Worktrees (worktree.*)

Setting	Description	Default
worktree.planning	Enable planning phase	false
worktree.interactivePlanning	Interactive planning mode	false
worktree.implementation	Enable implementation phase	true

Telemetry (telemetry.*)

Setting	Description	Default
telemetry.enabled	Send usage analytics	true
telemetry.crashReports	Send crash reports	true