# Agent Setup

ZoneGaze Flow can coordinate multiple coding agents. Configure the agent you want to use before starting real work.

## Open Settings

Click Settings from the top bar. The General section shows available agents and whether they are installed or need setup.

![Settings dialog with agent choices](./assets/screenshots/web-settings.png)

## Pick A Default Agent

Choose the agent that should run new tasks by default. Installed agents are marked in the settings panel. If an agent needs installation, use its install action or install it outside the app and refresh settings.

Supported agent surfaces may include:

- ZoneGaze Flow native agent
- Claude Code
- OpenAI Codex
- Factory Droid
- Kiro
- other CLI-backed agents exposed by the runtime

The exact list depends on your platform and local installation.

## Configure Provider Details

Some agents need provider, account, or model settings. Use the relevant settings section to add the provider, select a model, and complete any required authentication.

Keep secrets out of task prompts and screenshots. Use the app's provider setup flow or environment configuration instead of pasting API keys into tasks.

## Use Plan Mode

Enable plan mode when the task should start with a proposed implementation plan. This is useful for larger changes, ambiguous requirements, and work that needs explicit human approval before file edits.

## Override Agent Settings Per Task

Open a task card and expand Override Agent Settings when a single task needs a different model, provider, or behavior from your default.

## Check Readiness Before Starting

Before running an important task, confirm:

- the selected agent is installed or connected
- the provider is authenticated
- the project has the expected Git state
- the base ref is correct
- the task prompt includes validation instructions

If the task cannot start, check [Troubleshooting](./troubleshooting.md).
