mirror of https://github.com/Ark0N/Codeman.git synced 2026-10-09 16:59:43 +02:00

Files

T

Codeman maintainer b7fafb1c16 feat(tiles): the Tiles button opens the grid at once; the picker is on right-click

Owner decision 8 ("when I hit the tiles button, open the tiles already!").
A click with the grid closed now opens it straight away, and Ctrl+Shift+G
runs the same function (toggleTileGrid), so the two cannot drift. What
opens comes from one pure helper, tileGridOpenSet (constants.js):
  a. the grid this tab last had, if any of its sessions survive, opened
     exactly (an open split closes and its sessions do not join);
  b. else an open split's two sessions, Pane A focused;
  c. else the open sessions in tab order (the picker's list: no detached
     ones), up to what the grid takes here (the cap of 6, fewer when the
     window fits fewer), the active session always among them and focused.
A click with the grid open still closes it.

The picker moved to right-click (oncontextmenu, browser menu suppressed).
With the grid open it is preselected with the current tiles, and Open
replaces them. Ctrl/Cmd+click on a tab with the grid closed opens the
toggle's set plus that session. The button's title, the Help modal and
the wiki say right-click chooses which sessions.

Docs: decision 8 and an as-built entry in the spec (Entry points too),
CLAUDE.md, the invariants (#tile-grid, Opening), the wiki's Tile Grid and
Keyboard Shortcuts pages.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

2026-10-06 23:23:55 +02:00

5.7 KiB

Raw Blame History

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: one click shows the tiles straight away. You get the grid you last had; if there is none, an open split as two tiles; otherwise your open sessions in tab order, up to six (fewer if the window is too small), with the session you are on focused. With the grid open, the same button closes it.
Right-click the Tiles button to choose which sessions: a checkbox per open session in tab order, starting with the tiles you have (or had), greying out the rest once the grid is full. Open tiles shows them, replacing what the grid showed.
Ctrl+Shift+G: exactly what a click on the Tiles button does.
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.

5.7 KiB Raw Blame History Unescape Escape