# Configuration Reference

Runtime configuration is project-scoped where possible and global where needed. The contract is defined in `RuntimeConfigResponse` and `RuntimeConfigSaveRequest`.

## Agent Settings

- `selectedAgentId`
- `agentAutonomousModeEnabled`
- detected commands
- agent definitions
- effective command

Supported catalog entries include ZoneGaze Flow/Cline, Claude Code, OpenAI Codex, Factory Droid, Kiro, OpenCode, and Gemini. Launch support is validated by the runtime agent catalog before the UI treats an agent as runnable.

## Cline Provider Settings

- provider ID
- model ID
- base URL
- reasoning effort
- API key configured flag
- OAuth provider and token configured flags
- OAuth account ID and expiry

Secrets and OAuth tokens belong to the Cline SDK provider store, not Zonegaze Flow runtime config.

## Board And Workflow Flags

- parallel planning
- parallel implementation
- implementation execution mode
- work item hierarchy
- parent status cascade
- work type colors
- auto-create and launch
- auto-pick next
- concurrent descendant start
- planning hierarchy mode
- coordinator validation mode
- auto-publish planned cards

Default work types are Epic, Story, Task, and Subtask. Epic and Story are coordinator work types. Task and Subtask are executable work types. Subtask requires a parent, and allowed-parent validation is controlled by the work type registry.

## Shortcuts

Each shortcut has:

- label
- command
- optional icon

The selected shortcut is shown in the top bar and runs in the workspace shell session.

## Prompt Templates

- commit prompt template
- open PR prompt template
- default commit prompt template
- default open PR prompt template

## Project Context

Project context settings control retention, automatic updates, dynamic retrieval, conversation pruning, in-context compaction, procedural memory, zero-context subagents, tool schema optimization, governance approval, architecture rules, testing guidelines, and skill suggestions.

## Platform App Configuration

Direct Mac app behavior is controlled by the desktop package and Electron runtime configuration. The app starts the local runtime with automatic port selection from `127.0.0.1:3484`, adopts healthy runtimes on adjacent ports, registers `zonegaze-matrix://` plus legacy `zonegaze-flow://`, enriches PATH, and exposes dashboard, tray, and menu actions.

Direct Android app behavior is controlled by the Android package and the replaceable Android terminal backend. The app detects Matrix runtime ports `3484` through `3489`, IDE ports `3500` through `3505`, Vite ports `4217` and `4173`, and embedded asset ports `3490` through `3495`. `MatrixAndroidTerminalRequirements` records which Android modules need the owned terminal backend, can open without terminal, need an endpoint, or are planned. The current owned Zone Terminal runtime version gate is `52`.

## Access And Update Configuration

Remote access uses in-memory passcodes, in-memory browser sessions, rate limiting, and an internal CLI bearer token. Direct app updates are platform-specific: Mac users install a newer DMG, Android users install a newer APK and keep the app open while automatic setup refreshes the bundled runtime when needed, and CLI users follow package update guidance.

## Generated Reference

- [Runtime API reference](runtime-api.md)
- [Generated inventory](generated/inventory.md)
- [Generated source reference](generated/source/README.md)
- [ZoneGaze Flow core features](../features/zonegaze-flow-core-features.md)
- [Feature coverage matrix](../features/feature-coverage-matrix.md)
