mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-10-10 01:09:43 +02:00
Codeman maintainer
7e2b9ed8f6
An opencode tile showed only the session name, while Claude Code, codex and DeepSeek tiles add `· <model>`: opencode declared no `modelDetect`, so its screen was never read for a model and it is launched without a model param. opencode draws the model on its composer's agent row, directly above the box's bottom edge: `┃ Build Big Pickle OpenCode Zen`. Read from its own 1.3.0 source, the row is the agent, the model's name, the provider's name and `· <variant>` when the model has one, and only colour tells model from provider. So the field is all of it, exactly what opencode itself shows (the owner's choice over a short id that only appears after the first reply). - The pattern anchors on that row sitting directly above the `╹` edge, ends the field at a double space (where the 200-column layout's sidebar shares the row), skips the `No provider selected` placeholder, and takes the LAST such row in the window through a lookahead, so a composer-shaped row the agent prints higher up can never stand in for it. A test with a forged pair inside the window fails without the lookahead. - It reads 8 rows: the home screen puts up to five rows of opencode's own chrome under the composer (key hints, a tip, the cwd/version row). The schema's `screenLines` bound goes from 4 to 8, the reader's own cap; the comment there records why a taller window is only safe with such a pattern. - A permission prompt or shell mode hides the row; the last model is kept. Measured against every captured opencode 1.3.0 frame (home screen and in session, 40/60/120/200 columns, mid-turn and at rest, permission prompt): the model was read everywhere it is drawn and nowhere else. Live on an isolated instance from this branch, a restored opencode session published `displayModel: Big Pickle OpenCode Zen` (source: screen) and its tile header rendered `oc-home · Big Pickle OpenCode Zen`. The owner's own home-screen pane on the 1.36.0 beta reads the same. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
137 lines
8.7 KiB
Markdown
137 lines
8.7 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, on by default
|
||
everywhere except phones, and the button only appears in a window at least 1180px wide.
|
||
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, as many as you last chose
|
||
(six until you choose; fewer if the window is too small or you have fewer sessions open).
|
||
You get the grid you last had, its tiles where they were, topped up with your open
|
||
sessions in tab order; if there is none, an open split's two first; otherwise your open
|
||
sessions in tab order, with the session you are on focused. With the grid open, the same
|
||
button closes it.
|
||
- **Rest the pointer on the Tiles button** (or tab to it) for a short card that shows the
|
||
count it opens and what a click and a right-click do.
|
||
- **Right-click the Tiles button** (or press `Shift+F10` on it) to choose how many tiles:
|
||
**2**, **4** or **6**, each drawn as its layout. Your choice is remembered on this device
|
||
and is what the next click opens. With the grid open, picking a count re-forms it: the
|
||
tile you are in always stays, extra tiles leave from the end, new ones join from your tab
|
||
order. A count the window is too small for is greyed out, with the reason.
|
||
- **`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. With
|
||
the grid closed it opens what the Tiles button would show, with that session among them
|
||
(still the count you chose in total). 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 count menu says which limit applies.
|
||
|
||
Opening, the tiles fade in one after another and each terminal appears once its history
|
||
has loaded, rather than scrolling through it. Closing with the button, the tiles stay
|
||
on screen, dimmed, until the single session behind them has loaded, then fade away. With
|
||
reduced motion turned on in your system settings, the grid opens and closes at once.
|
||
|
||
## A tile
|
||
|
||
Each tile has a small header: `● [logo] name · model ......... ⋯ ⤢ ×`
|
||
|
||
| 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. |
|
||
| logo | Which agent runs in the tile (Claude Code, Codex, DeepSeek, Shell, ...). Hover it for the agent and the model by name. |
|
||
| name | Double-click to rename the session. |
|
||
| model | The model the session runs, when Codeman knows it: what the agent itself reports (it follows a `/model` switch), else the model its own config pins (DeepSeek's route, shown "from config"), else the model it was started with. Nothing when unknown. OpenCode shows the model and its provider together (`Big Pickle OpenCode Zen`), exactly as its own composer does. |
|
||
| `⋯` | 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. |
|
||
| `×` | 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 `⋯`.
|
||
|
||
## Moving tiles
|
||
|
||
Drag a tile by its header (anywhere but its buttons) onto another tile and the two trade
|
||
places. Drop it on an empty slot and it moves there, leaving its old place empty; nothing else
|
||
moves, so the empty slot can be anywhere in the grid. The dropped tile takes the focus. Press
|
||
`Escape` or let go anywhere else and nothing changes, not even which tile has the focus: a
|
||
header focuses its tile when you click it, not when you press it.
|
||
|
||
With the keyboard, `Ctrl+Shift+Arrows` moves the focused tile one place left, right, up or
|
||
down: into the empty slot if that is the place, else trading places with the tile there. It
|
||
keeps the focus.
|
||
|
||
A moved tile takes the size of the place it lands in: column widths and row heights stay
|
||
where you dragged the dividers. Tiles do not move while one is zoomed. Where everything is,
|
||
the empty slot included, is saved with the grid and comes back on reload.
|
||
|
||
Closing a tile leaves its place empty when the grid keeps its shape (six tiles to five), and a
|
||
new tile takes the first empty place. When the number of tiles changes the grid's shape (four
|
||
tiles to five is two columns to three), the tiles keep their places if they still fit, or line
|
||
up again from the top left. `Alt+Shift+Arrows` and `Ctrl+Tab` never stop on an empty slot.
|
||
|
||
## Keys
|
||
|
||
| Shortcut | Action |
|
||
| ------------------------ | ---------------------------------------------------------- |
|
||
| `Ctrl+Shift+G` | Open or close the grid. |
|
||
| `Alt+Shift+Arrows` | Focus the tile to the left, right, above or below. |
|
||
| `Ctrl+Shift+Arrows` | Move the focused tile left, right, up or down. |
|
||
| `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`, `Ctrl+Shift+Arrows` and
|
||
`Alt+Shift+Enter` go to the terminal as usual. While it is open, `Alt+Shift+Arrows` and
|
||
`Ctrl+Shift+Arrows` in a text field (renaming a tile, the file editor) still select text there;
|
||
inside a tile they focus and move tiles, so a terminal editor there (nano, micro, emacs) does
|
||
not get them. 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.
|
||
|
||
Split shows the same logo, name and model above both of its panes.
|
||
|
||
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.
|