34 lines
2.4 KiB
Markdown
34 lines
2.4 KiB
Markdown
# 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.
|