# Getting Started

This guide takes you from first launch to your first reviewed task.

## 1. Launch ZoneGaze Flow

Open the Mac app, Android app, or CLI entrypoint. The app opens the local control surface and checks whether the runtime is available.

![First-run onboarding in ZoneGaze Flow](./assets/screenshots/web-onboarding.png)

If the app asks you to complete setup, follow the prompt before starting a task. A supported agent and a project workspace are the two most important requirements.

## 2. Select A Project

The project sidebar shows available workspaces. Select the project you want the agent to work in, or use Add Project to register another local folder.

![Board with project sidebar and workflow columns](./assets/screenshots/web-board-overview.png)

Use a project that is safe for local agent work. For best results, start from a clean Git state and make sure the expected base branch is current.

## 3. Create A Work Item

Click Create task in Backlog. Write a concrete prompt that explains the intended outcome, relevant constraints, and what should count as done.

![Create task composer with an example prompt](./assets/screenshots/web-create-task.png)

Good prompts include:

- the exact user-facing or technical outcome
- files, routes, commands, or context the agent should inspect
- validation you expect before completion
- limits, such as no deployment or no unrelated refactors

## 4. Review The Card

Open the card before starting it. Confirm the work type, parent task, base ref, plan mode, and automatic review behavior.

![Task detail view before starting work](./assets/screenshots/web-task-detail.png)

Use Start in plan mode when you want the agent to propose a plan before changing files.

## 5. Start And Monitor

Start the task. ZoneGaze Flow tracks the task state and exposes the agent output, terminal, and review surfaces in the same workspace.

[Watch the first-task walkthrough](./assets/videos/web-first-task-walkthrough.webm)

<video controls src="./assets/videos/web-first-task-walkthrough.webm" title="First task walkthrough"></video>

## 6. Review Before Shipping

Do not treat an agent run as finished until you inspect the changed files and local validation. Use [Review and ship](./review-and-ship.md) for the full review flow.

## Next Steps

- Configure agents in [Agent setup](./agent-setup.md).
- Learn the full task lifecycle in [Core workflow](./core-workflow.md).
- Check platform-specific notes in [Platform notes](./platforms.md).
