mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-11-22 05:49:33 +01:00
93 lines
5.4 KiB
Markdown
93 lines
5.4 KiB
Markdown
# Tile Grid
|
||||
|
|
|
|||
|
|
Watch and drive up to nine sessions at once, side by side in one window. Each tile is a
|
|||
|
|
full live terminal: it reads, it takes your keystrokes, and it shows at a glance whether
|
|||
|
|
its agent is working, idle, or waiting on you.
|
|||
|
|
|
|||
|
|
The grid is a desktop feature. It needs a window at least about 1180px wide, and it is
|
|||
|
|
never offered in a popped-out session window.
|
|||
|
|
|
|||
|
|
## Turning it on
|
|||
|
|
|
|||
|
|
**App Settings → Header & Panels → Tiles.** This is a per-device setting, off by default,
|
|||
|
|
so turning it on at your desk never puts the button on your phone. It shows a **Tiles**
|
|||
|
|
button in the header, beside Split, and enables `Ctrl+Shift+G`.
|
|||
|
|
|
|||
|
|
## Opening a grid
|
|||
|
|
|
|||
|
|
- **Tiles button**: with the grid closed it opens a picker, a checkbox per open session in
|
|||
|
|
tab order. It starts with the grid you last had (or the session you are on), says how many
|
|||
|
|
tiles this window fits, and greys out the rest. **Open tiles** shows them. With the grid
|
|||
|
|
open, the same button closes it.
|
|||
|
|
- **`Ctrl+Shift+G`**: toggles the grid. Opening brings back the grid you last had, else an
|
|||
|
|
open split as two tiles, else the session you are on.
|
|||
|
|
- **`Ctrl`+click (or `Cmd`+click) a tab**: adds that session to the grid and focuses it,
|
|||
|
|
opening the grid if it was closed. On macOS use `Cmd`: `Ctrl`+click there opens the tab's
|
|||
|
|
rename instead.
|
|||
|
|
- **Drag a tab onto a tile** to replace that tile with it (the replaced session keeps
|
|||
|
|
running), or onto an empty slot to add it. Dragging a session that is already tiled onto
|
|||
|
|
another tile swaps the two.
|
|||
|
|
- **"Open group as tiles"** in a tab group's menu, in the vertical tab rail with groups.
|
|||
|
|
- **Run**: a session you start from this browser tab's Run button while the grid is open
|
|||
|
|
joins it. Sessions started elsewhere (an agent, another device, a cron job) do not.
|
|||
|
|
|
|||
|
|
The layout follows the tile count: 1x1, 2x1, three side by side on a wide screen (else a
|
|||
|
|
2x2 with one empty slot), 2x2, 3x2, 3x3.
|
|||
|
|
|
|||
|
|
## A tile
|
|||
|
|
|
|||
|
|
Each tile has a small header: `● name ......... ⋯ ⤢ + ×`
|
|||
|
|
|
|||
|
|
| Part | What it does |
|
|||
|
|
| ------ | ------------------------------------------------------------------------------------------------ |
|
|||
|
|
| `●` | The session's state: working, idle, waiting on you, needs you (red, and the tile's border pulses), error, ended. Hover the header for how long. |
|
|||
|
|
| name | Double-click to rename the session. |
|
|||
|
|
| `⋯` | The session menu: options, open in a new window, close the session. |
|
|||
|
|
| `⤢` | Zoom: the tile fills the grid; press it again (or `Alt+Shift+Enter`) to get the grid back. |
|
|||
|
|
| `+` | Add a session that is not tiled yet, or start a new session in this tile's case. |
|
|||
|
|
| `×` | Remove the tile. The session keeps running; close it from `⋯` if you want it gone. |
|
|||
|
|
|
|||
|
|
Click a tile to focus it. The focused tile has the accent border, takes your keyboard, and
|
|||
|
|
is the session every panel follows: files, git status, respawn and Ralph, subagent windows,
|
|||
|
|
voice and image paste. Tabs of tiled sessions carry a small underline.
|
|||
|
|
|
|||
|
|
Drag the thin lines between tiles to resize columns and rows. A tile never gets smaller than
|
|||
|
|
about 60 columns; when the window is too small for all the tiles, the grid shows the focused
|
|||
|
|
one on its own until the window is big enough again.
|
|||
|
|
|
|||
|
|
A tile whose session is not running shows **Not attached** with an **Attach** button. A tile
|
|||
|
|
whose agent exited inside its pane says so instead; close that session from `⋯`.
|
|||
|
|
|
|||
|
|
## Keys
|
|||
|
|
|
|||
|
|
| Shortcut | Action |
|
|||
|
|
| ------------------------ | ---------------------------------------------------------- |
|
|||
|
|
| `Ctrl+Shift+G` | Open or close the grid. |
|
|||
|
|
| `Alt+Shift+Arrows` | Focus the tile to the left, right, above or below. |
|
|||
|
|
| `Alt+Shift+Enter` | Zoom the focused tile, or restore the grid. |
|
|||
|
|
| `Ctrl+Tab`, `Alt+[` `]` | Cycle through the tiles. |
|
|||
|
|
| `Ctrl+L` | Clear the focused tile. |
|
|||
|
|
| `Ctrl` `+` / `Ctrl` `-` | Tile font size (tiles have their own, smaller font). |
|
|||
|
|
|
|||
|
|
All of them can be rebound in App Settings → Shortcuts, where **Remove Focused Tile** can
|
|||
|
|
also get a key. Outside the grid, `Alt+Shift+Arrows` and `Alt+Shift+Enter` go to the
|
|||
|
|
terminal as usual. With the Tiles setting off, `Ctrl+Shift+G` does nothing.
|
|||
|
|
|
|||
|
|
## Leaving the grid
|
|||
|
|
|
|||
|
|
Clicking the tab of a session that is not tiled (or picking it with `Alt+1-9` or the
|
|||
|
|
session finder) shows that session on its own, the normal single view. The grid is
|
|||
|
|
remembered: the Tiles button or `Ctrl+Shift+G` brings it straight back. Going Home does the
|
|||
|
|
same. Narrowing the window below the desktop width also returns to the single view.
|
|||
|
|
|
|||
|
|
The grid is saved on this device and comes back when you reload the page, with its focus,
|
|||
|
|
zoom and column widths. A session that was closed in the meantime is simply left out.
|
|||
|
|
|
|||
|
|
The grid and Split are never open together: opening the grid turns an open split into two
|
|||
|
|
tiles, and Split is unavailable while the grid is open.
|
|||
|
|
|
|||
|
|
## Read next
|
|||
|
|
|
|||
|
|
- [The Dashboard](The-Dashboard) - the single view, tabs and the header.
|
|||
|
|
- [Keyboard Shortcuts](Keyboard-Shortcuts) - every binding.
|
|||
|
|
- [Settings Reference](Settings-Reference) - where the Tiles setting lives.
|