# Quick Dock

A column of floating windows on the right side of the conversation area. It gathers the "interactive artifacts produced during a task" in one place, so you can keep an eye on everything without scrolling through the message stream.

---

## 1. The Five Windows

From top to bottom:

| Window | What it shows | Typical actions |
|------|----------|------|
| **Workflow** | The currently active workflow: which stage it is at, review status, pending branches | Check process progress; use alongside branch selection |
| **Todos** | The AI-created task list (todo): completion status of each item | See how far the AI's execution plan has advanced |
| **Sub agents** | Running/idle sub agent instances: status, what they are currently doing | Open details to see the output timeline; use the ⋯ menu to **force-close** an out-of-control instance |
| **Background commands** | Command tasks running in the background: status, elapsed time | Open details to see the full output; force-close from the ⋯ menu |
| **File records** | Files the AI has edited or created in the current task | ⋯ menu: **download** / **open in file manager** (host mode) / **copy path** |

### Details panel

- Click a sub agent / background command entry → opens the **runner details panel**: outputs and tool calls are interleaved on a real timeline; you can force-close when something runs out of control;
- Click a file entry → opens the **file preview panel**: view the file content directly. Long lines scroll horizontally by default; in Personal Space you can switch to wrapping by panel width.

## 2. Expand and Collapse

- **Auto-expand when there is content** (default): when any window has content, the whole column expands automatically; when all are empty, it collapses into a thin edge strip that takes up no space;
- In Personal Space you can switch to **manual expand only** (`quick_dock_auto_expand`), or **hide entirely** (`hide_quick_dock`).

## 3. Usage Tips

- **Watch for runaway processes**: when a sub agent or background command misbehaves, don't shout into the conversation — just use ⋯ → force close;
- **Watch progress**: during long tasks, the Todos window plus the Sub agents window is your project board;
- **Collect artifacts**: when the task ends, batch-download or jump to the directory from the File records window — much faster than hunting through cards in the message stream.