# Feature Catalog

This catalog is the compact feature index for ZoneGaze Flow. Use the [core feature guide](zonegaze-flow-core-features.md) for behavior details and the [feature coverage matrix](feature-coverage-matrix.md) for source links, media evidence, and coverage status.

## Core ZoneGaze Flow Features

### Project Management

- Add projects from local paths, remote browsing, manual path entry, Git clone, or Git initialization.
- Switch projects, remove projects, clean associated runtime state, and open workspaces in supported local tools.
- Handle disconnected runtime, blocked access, no-project, and no-agent-ready states.

### Board And Work Items

- Lanes: Plan Later, Plan Review, Backlog, Next Up, In Progress, Review, Done, and Archive.
- Archive, deleted, removed, and restored work areas.
- Create, edit, title, tag, filter, sort, move, restore, archive, delete, and remove work items.
- Split pasted lists into multiple tasks.
- Attach images and use file mentions in prompts.
- Assign base refs, agents, provider/model/reasoning overrides, plan mode, auto-commit, auto-PR, parent task, work type, and child prompts.

### Work Types And Dependencies

- Default hierarchy: Epic, Story, Task, Subtask.
- Coordinator and executable work type behavior.
- Parent-required and allowed-parent validation.
- Work type labels, colors, icons, enable/disable state, and hierarchy validation.
- Dependency linking, blocked/ready state, linked-task start, and chained work.

### Planning And Home Agent

- ZoneGaze Flow Agent sidebar session for planning, task creation, task editing, linking, and summarization.
- Plan Later and Plan Review staging.
- Coordinator-generated work items and publish-to-Backlog flow.
- Parallel planning, parallel implementation, sequential modes, parent cascade, auto-pick next, and coordinator validation flags.

### Agents And Cline

- Agent catalog: ZoneGaze Flow/Cline, Claude Code, OpenAI Codex, Factory Droid, Kiro, OpenCode, and Gemini.
- Native ZoneGaze Flow/Cline SDK sessions with provider, model, custom provider, OAuth, device auth, API key, account, reasoning, Plan/Act, prompt history, slash commands, images, file mentions, queued messages, persisted chat, cancellation, tool labels, token snapshots, and context recovery.
- CLI agents through PTY-backed task sessions.
- MCP server configuration for stdio, SSE, and streamable HTTP transports with environment variables, headers, OAuth status, connect, and reconnect behavior.

### Terminal, Review, Git, And Worktrees

- Workspace shell, persistent terminal mirror, reconnect, resize, clear, stop, restore, expand, minimize, and shortcut execution.
- Detail view with chat or terminal, task children, file tree, column context, latest activity, warnings, progress, working-copy diff, last-turn diff, unified/split diff, binary handling, line/range comments, send-comments-to-agent, commit, PR, and move-to-Done actions.
- Git branch, upstream divergence, changed file count, additions/deletions, fetch, pull, push, checkout, refs, commit history, commit search, commit diff, working-copy diff, task worktree diff, and explicit discard actions.
- Task worktree ensure/delete, metadata, path labels, detached/head state, changed file summary, and patch preservation for trashed tasks.

### Settings, Context, Access, And Updates

- Settings sections: General, ZoneGaze Flow/Cline, Work Types, Git Prompts, Notifications, Appearance, Project Context, and Project.
- Project context: user profile, project memory, context files, retention, auto update, dynamic retrieval, pruning, compaction, procedural memory, zero-context subagents, tool schema optimization, governance, architecture, testing, and skill suggestions.
- Secure remote access with passcode, in-memory sessions, rate limiting, internal CLI token, host/origin validation, and passcode gate UI.
- PWA support, update detection, Featurebase feedback, notifications, shortcuts, top-bar runtime controls, and mobile overflow controls.

### Matrix Plugins And Downloads

- The Flow sidebar has the Plugins section for ZoneGaze apps and plugins.
- The shared catalog lists ZoneGaze Flow as the built-in core product, with ZoneGaze Whispr and ZoneGaze Code as downloadable plugins.
- Whispr can be downloaded from the ZoneGaze downloads hub or opened directly when the desktop app is installed.
- ZoneGaze Code is a Code-OSS-based workspace IDE plugin with a Mac app target and Android Zone Terminal code-server adapter.
- The Plugin surface does not show a donation action until a verified payment destination is enabled.
- Starter application targets are Mac and Android, with the catalog preserving web/CLI metadata only where the source already supports it.

Owner docs:

- [Matrix plugin architecture](../architecture/matrix-plugin-architecture.md)
- [Support funding](../architecture/support-funding.md)
- [Whispr import note](../../plugins/whispr/MATRIX-IMPORT.md)
- [Code plugin note](../../plugins/code/MATRIX-PLUGIN.md)

## Direct Mac App Features

- Download/install by DMG without cloning the repository or running npm commands.
- Electron app id `com.zonegaze.matrix`, primary deep-link scheme `zonegaze-matrix://`, and legacy-compatible scheme `zonegaze-flow://`.
- Starts a local runtime from `127.0.0.1:3484` with automatic fallback to the next free runtime port, detects adjacent runtime ports, and verifies the runtime title before attaching.
- Dashboard actions: refresh, launch/open, start, stop, restart, copy URL, open browser.
- Tray actions: open app, open dashboard, open browser, new window, start, stop, restart, refresh, and quit.
- Menus: app, file, edit, view, window, and help.
- Multiple windows, restored bounds, hide-on-close behavior on Mac, app-nap prevention, crash/disconnect recovery, PATH enrichment, bundled runtime/web assets, and OAuth callback relay.

Owner doc: [Direct Mac application](../platforms/direct-mac-application.md)

## Direct Android App Features

- Direct APK install with package id `com.zonegaze.matrix`.
- Native dashboard with status, collapsible sections, automatic setup progress, start, stop, copy URL, open, and pending action states.
- App-owned Zone Terminal automatic runtime setup, plugin install/uninstall records, retry/repair actions, runtime bundle extraction from embedded assets, Node/Git/build tool readiness, and runtime version gate.
- Runtime ports `3484` to `3489`, IDE ports `3500` to `3505`, Vite dev port `4217`, preview port `4173`, and runtime asset ports `3490` to `3495`.
- WebView shell for local ZoneGaze Flow and ZoneGaze Code with external HTTP(S) links opened outside the app.
- Git identity, SSH key generation, public key copy, project folder storage, `/sdcard` storage setup, logs, repair command, setup log command, APK/runtime update path, and troubleshooting states.

Owner doc: [Direct Android application](../platforms/android-application.md)

## Visual Reference

Core workflow video: [open core working demo](../assets/videos/zonegaze-flow-core-working-demo.webm)

![ZoneGaze Flow core working demo video](../assets/videos/zonegaze-flow-core-working-demo.webm)

Mac workflow video: [open Mac full workflow](../assets/videos/zonegaze-flow-mac-full-workflow.webm)

![ZoneGaze Flow Mac full workflow video](../assets/videos/zonegaze-flow-mac-full-workflow.webm)

Android dashboard setup video: [open Android dashboard setup recording](../assets/videos/zonegaze-flow-android-dashboard-setup.mp4)

![ZoneGaze Flow Android dashboard setup video](../assets/videos/zonegaze-flow-android-dashboard-setup.mp4)

Screenshots:

- [Board input](../assets/screenshots/core-board-input.png)
- [Create task process](../assets/screenshots/core-create-task-process.png)
- [Settings process](../assets/screenshots/core-settings-process.png)
- [Git/review output](../assets/screenshots/core-git-output.png)
- [Archive result](../assets/screenshots/core-archive-result.png)
- [Produced website result](../assets/screenshots/core-produced-website-result-page.png)
- [Mac dashboard](../assets/screenshots/mac-desktop-dashboard.png)
- [Android emulator dashboard](../assets/screenshots/android-emulator-dashboard.png)

## Documentation Links

- [Software manual](../manual/software-manual.md)
- [Platform application guides](../platforms/README.md)
- [Cline integration](cline-integration.md)
- [Runtime API reference](../reference/runtime-api.md)
- [Generated inventory](../reference/generated/inventory.md)
