mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-10-09 00:49:41 +02:00
Codeman maintainer
d2e72143e8
Six was tested smooth on the owner's desktop; nine missed the headless frame bar and is untested on real hardware. TILE_GRID_MAX (constants.js) is now 6 and stays the one cap every limit reads; the layout table gets its own bound, TILE_LAYOUT_MAX = 9, so the 7 to 9 layouts keep working (unreachable) and going back to nine is that one line. Every way in stops at the cap: opening, addTile, a tile's +, a session Run makes, Ctrl/Cmd+click, the picker, "Open group as tiles", and a stored grid with more ids (it comes back as its first six, focus kept only if it survives, a dropped zoom cleared, row fractions that no longer match the 3x2 reset). The limits now go through one helper, _tileGridLimit(), whose texts say which limit binds: "Up to 6 tiles" / "The grid holds at most 6 tiles" when it is the cap, "This window fits N" when it is the window. Docs: decision 7 and an as-built entry in the spec, CLAUDE.md, the invariants, the wiki's Tile Grid and Dashboard pages. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
95 lines
5.5 KiB
Markdown
95 lines
5.5 KiB
Markdown
# Tile Grid
|
||
|
||
Watch and drive up to six 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. The grid holds at most six tiles, fewer when the
|
||
window is too small for six; the picker and a tile's + say which limit applies.
|
||
|
||
## 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.
|