mirror of https://github.com/Ark0N/Codeman.git synced 2026-10-10 01:09: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.6 KiB

Raw Blame History

Keyboard Shortcuts

Every binding, and how to change them. Ctrl also accepts Cmd on macOS.

Press Ctrl+? in the app for the same list in a floating overlay.

Sessions and tabs

Shortcut	Action
`Ctrl+K` (also `Cmd+K`, `Alt+K`)	Find an open session or start a new one.
`Ctrl+Tab`	Next session.
`Alt+[` / `Alt+]`	Previous / next tab.
`Alt+1` to `Alt+9`	Switch to tab N. Physical keys, so macOS Option layouts work.
`Ctrl+Shift+{` / `Ctrl+Shift+}`	Move the active tab left / right.
`Alt+B`	Collapse / expand the session sidebar, when that layout is on.

Ctrl+W is not a Codeman shortcut: it goes to the terminal, where shells and agent CLIs use it to delete the previous word. Close Session has no key by default; close a session from its tab, or bind a key to it in App Settings → Shortcuts.

Terminal

Shortcut	Action
`Enter`	Send.
`Shift+Enter`	Insert a newline without sending.
`Ctrl+Enter`	Same.
`Ctrl+C`	Copy the selection, or interrupt when nothing is selected.
`Ctrl+Shift+C`	Copy the selection. Never interrupts.
`Ctrl+V`	Paste. An image on the clipboard uploads and pastes its file path instead.
`Ctrl+L`	Clear the terminal.
`Ctrl+Shift+R`	Restore terminal size.
`Ctrl` `+` / `Ctrl` `-`	Font size.
`Shift+Wheel`	Scroll the local buffer, even where the wheel is forwarded to the CLI.
`Shift+drag`	Start a selection in a pane whose mouse events go to the CLI.
Right-click	Copy the selection. With nothing selected the native menu is left alone.
`Ctrl+Z`	Swallowed in agent sessions so a running CLI cannot be suspended. Normal job control in a shell.

Anything you copy is cleaned on the way to the clipboard: each line loses the padding spaces a full-screen program paints across the rest of the row. Leading indentation is left exactly as it is, so indented code, a git log message body and git diff context lines paste back the way they looked on screen. An Alt+drag rectangular selection is copied exactly as it looks, so its columns stay lined up.

Tile grid

Shortcut	Action
`Ctrl+Shift+G`	Open or close the tile grid (needs the Tiles setting on).
`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`+click / `Cmd`+click a tab	Add that session to the grid.
Right-click the Tiles button	Choose which sessions to show as tiles.

While the grid is open, Ctrl+Tab and Alt+[ / Alt+] cycle through the tiles, and the terminal shortcuts above act on the focused tile. Remove Focused Tile has no key by default. See Tile Grid.

Everything else

Shortcut	Action
`Ctrl+Shift+V`	Toggle voice input.
`Ctrl+?`	Shortcut reference overlay.
`Escape`	Close panels and modals.

Rebinding

App Settings → Shortcuts. Bindings live in a registry with per-user overrides, so a rebind is stored as an override on top of the default rather than replacing the table.

Two things are deliberately not rebindable:

Ctrl+C smart copy. The generic dispatch loop calls preventDefault() on every shortcut it handles, and doing that to Ctrl+C would swallow the interrupt when nothing is selected. It is handled separately for that reason.
Escape, which closes whatever is open.

Why some chords behave oddly

The terminal sees keystrokes before the app does. Any chord the app claims has to also be swallowed at the terminal layer, or xterm writes the control byte into the session as well as triggering the action. If you rebind something to a chord the terminal cares about (Ctrl+D, say), expect the CLI to see it too.

Alt+1 through Alt+9 are matched on physical key position rather than the character produced, so macOS Option layouts that produce ¡™£ still switch tabs.

On phones

There is no physical keyboard, so the equivalents live in the keyboard accessory bar: Esc, Ctrl as a one-shot modifier, Tab, arrows, and quick actions. See Mobile Guide.

5.6 KiB Raw Blame History