# How-To Guide

## Create Linked Tasks

1. Create two or more tasks.
2. Hold <kbd>Cmd</kbd> and click one card, then click another, to link a blocker task to a dependent task.
3. Start the unblocked task.
4. When the predecessor is completed and moved to Done, ZoneGaze Flow auto-starts the linked tasks that are now ready. Combine with auto-commit for fully autonomous dependency chains.

![Board overview used for creating and linking tasks](../assets/screenshots/board-overview.png)

## Start A Task In Plan Mode

1. Open the task create dialog or detail settings.
2. Enable plan mode.
3. Start the task.
4. Review the plan before switching to execution when your agent supports Plan/Act behavior.

![Create task dialog with plan mode and launch controls](../assets/screenshots/create-task-dialog.png)

## Create A Typed Work Item

1. Open the create-task dialog.
2. Pick a work type such as Epic, Story, Task, or Subtask.
3. Choose a parent when the selected type requires one.
4. Add prompt text, optional child prompts, tags, file mentions, and images.
5. Choose agent, base ref, plan mode, and auto-review behavior.
6. Create the card.

![Create task dialog with work type, parent, base ref, and agent settings](../assets/screenshots/core-create-task-process.png)

## Use Cline MCP Servers

1. Open Settings.
2. Open the Cline/ZoneGaze Flow setup section.
3. Add a stdio, SSE, or streamable HTTP MCP server.
4. Provide environment variables or headers if needed.
5. Connect OAuth for servers that support it.
6. Save settings and start a new or refreshed Cline session.

![Settings dialog where Cline and ZoneGaze Flow agent settings are configured](../assets/screenshots/settings-dialog.png)

## Add Diff Comments

1. Open a task in Review.
2. Open a file in the diff panel.
3. Click a line number, or select a range when range comments are available.
4. Enter the comment.
5. Add it to the draft or send it directly to the task agent.

## Run A Script Shortcut

1. Open Settings.
2. Add a shortcut label, command, and icon.
3. Select the shortcut in the top bar.
4. Press the shortcut run control.
5. The shell session interrupts prior shortcut output before running the selected command.

![Terminal panel for shortcut and shell output](../assets/screenshots/terminal-panel.png)

## Review A Task Result

1. Open a task in Review, Done, or any lane with output.
2. Inspect the chat or terminal transcript.
3. Open the file tree and review working-copy or last-turn diffs.
4. Add line or range comments if feedback is needed.
5. Send comments back to the agent, commit, open a PR, move to Done, archive, or remove the task.

![Git and review output surface](../assets/screenshots/core-git-output.png)

## Sync With Your Git Remote

1. On the board (home view), find the branch chip and the working-copy summary (`N files +A −D`) in the top bar.
2. Click the **Sync** control (shows `N↓ N↑`, the behind/ahead commit counts) to open the sync popover.
3. Choose **Fetch from upstream** (update refs only), **Pull from upstream**, or **Push to upstream** — each row describes what it does before you run it.

## Use Git History

1. Open Git History by clicking the branch name in the top bar, or press <kbd>Cmd</kbd>+<kbd>G</kbd>.
2. Inspect local and remote refs.
3. Search or load more commits.
4. Select a commit to inspect its diff.
5. Use branch checkout only when the target branch is clear and the working copy is safe.

![Git history view with branches, commits, and diff](../assets/screenshots/git-history.png)

## Update ZoneGaze Flow

1. Watch for the update notification.
2. Use the update dialog to run the supported install command.
3. If the installation type is unsupported, update with your package manager.

## Use The Direct Mac App

1. Install the DMG from the trusted distribution channel.
2. Open `ZoneGaze Flow.app`.
3. Use the dashboard or tray menu to start or adopt the local runtime.
4. Add or select a project.
5. Use the same board, agents, Git, terminal, and settings features documented in the core guide.

![Mac application-only dashboard](../assets/screenshots/mac-desktop-dashboard.png)

## Set Up The Direct Android App

1. Install the APK from the trusted distribution channel.
2. Open `ZoneGaze Matrix`.
3. Keep the app open while the owned Zone Terminal runtime sets itself up.
4. Watch setup progress on **Dashboard** or **Runtime**.
5. Choose a launch folder and configure Git or SSH if needed.
6. Install the plugins you want from **Plugin**.
7. Tap **Start**, then **Open**, for the selected runtime-backed surface.

![Android emulator dashboard and owned runtime setup state](../assets/screenshots/android-emulator-dashboard.png)

## More Procedures

- [Troubleshooting](troubleshooting.md)
- [Configuration reference](../reference/configuration.md)
- [CLI reference](../reference/cli.md)
- [ZoneGaze Flow core features](../features/zonegaze-flow-core-features.md)
- [Direct Mac application](../platforms/direct-mac-application.md)
- [Direct Android application](../platforms/android-application.md)
