taikutaiku
User GuidePluginsAPI Reference

Terminals & tiling

Split your workspace into tiles, navigate them by keyboard, and find anything fast with the command palette.

taiku arranges your terminals as tiles that fill the screen — no floating windows, no hunting for a hidden pane, and everything reachable from the keyboard.

A single terminal split into a tiled layout, then a tile maximized and restored, then closed and reopened

You start every session with one terminal filling the screen. From there you split it into the layout you want, move focus between tiles, and pull up the tools you need with a keystroke.

Most layout shortcuts use Ctrl+Shift in the browser, or Cmd+Shift in the desktop app (the same physical chord). A second set uses Ctrl+Alt on Windows and Linux, which is Cmd+Option on macOS. Every built-in shortcut is rebindable — see Customize your shortcuts.

Tiled layouts

Build a layout by splitting the focused tile:

  • Split side by side with Ctrl+Shift+H. A new terminal opens to the right, sharing the space equally.
  • Split top and bottom with Ctrl+Shift+V. A new terminal opens below the focused tile.
  • Add a fresh terminal with Ctrl+Shift+N, or open a browser tile with Ctrl+Shift+B.

Drag the divider between two tiles to resize them. To even everything back out, press Ctrl+Shift+G to reset to a balanced grid, or Ctrl+Shift+E to flip the split direction of the current group.

ShortcutAction
Ctrl+Shift+HSplit side by side (new tile right)
Ctrl+Shift+VSplit top and bottom (new tile)
Ctrl+Shift+NNew terminal
Ctrl+Shift+BOpen a browser tile
Ctrl+Shift+EFlip the group's split direction
Ctrl+Shift+GReset to a balanced grid
Ctrl+Shift+RRename the focused tile

Move between tiles

Move focus with the arrow keys (Ctrl+Shift+Arrow) or the home-row keys Ctrl+Shift+J, K, L, and ;. Cycle through every tile with Ctrl+Shift+Tab, or jump straight to one by its slot number with Ctrl+Shift+19. Slot numbers run left to right, top to bottom, and show in each tile's titlebar.

Maximize & restore

When you want one tile to take over, press Ctrl+ArrowUp to maximize it to the full viewport. Press Ctrl+ArrowDown to restore the layout exactly as it was. This is handy when you want to read a long log or focus on a single agent without losing the rest of your panes.

To tuck a tile away without closing it, minimize it with Ctrl+Shift+M.

ShortcutAction
Ctrl+ArrowUpMaximize the tile
Ctrl+ArrowDownRestore the sizes
Ctrl+Shift+MMinimize the tile

Reopen & swap tiles

Closed a tile by mistake? Press Ctrl+Shift+T to reopen the last one you closed. To rearrange your layout, drag a tile by its titlebar and drop it onto another to swap the two.

Dragging a tile by its titlebar and dropping it onto another to swap their positions
ShortcutAction
Ctrl+Shift+QClose the focused tile
Ctrl+Shift+TReopen the last closed

Each tile can also hold multiple tabs. Open a tab with Ctrl+T, close one with Ctrl+W, switch tabs with Ctrl+[ / ] or Ctrl+19.

Command palette

The command palette is the fastest way to do anything in taiku. Press Ctrl+Shift+P to open it, start typing, and it fuzzy-matches commands, tiles, and actions as you go. Run the highlighted result with Enter — no need to remember the exact shortcut.

Opening the command palette and fuzzy-searching to jump to a command without remembering its shortcut

Use it to split tiles, switch pages, open panels, browse clipboard history, or jump to a specific terminal. It's also where you reach actions that have no default shortcut, like starting a tile recording.

Find across tiles

Press Ctrl+F to search inside the focused terminal. Find works across every tile type — terminals, browser tiles, file previews, and diffs — so the same keystroke searches whatever you're looking at. Close the find bar with Ctrl+Shift+F.

Using find to search inside a terminal, a file preview, and a browser tile with the same shortcut

Workspace pages

A single session can hold several pages, each with its own layout — keep one page for your build terminals and another for a browser preview and notes. Switch between pages with Ctrl+Shift+[ and Ctrl+Shift+], or jump straight to a page by number with Ctrl+Alt+19. Create a new page with Ctrl+Shift+\.

Switching between workspace pages, each holding its own tile layout

Your layout — split ratios, tile positions, tabs, and which tile is maximized — is saved per device and restored when you refresh. Opening the same session in a different browser or app starts with a fresh layout.

Clipboard history

Every time you copy text from a taiku terminal, it's added to your clipboard history with a timestamp — so the thing you copied five commands ago is still one keystroke away.

Browsing clipboard history in the command palette and pasting an earlier copied snippet into a terminal

There are two histories that work side by side:

  • Your clipboard is private to this device. It holds your recent copies, whether you used Cmd+C, the right-click menu, or the touch toolbar on mobile.
  • The shared clipboard is visible to everyone in the session. When you copy, the clip appears in everyone's shared history tagged with your name — so a teammate can grab your stack trace without you re-sending it.

Open clipboard history from the command palette (switch it to clipboard mode), or jump straight to your device history with Ctrl+Alt+C. From there you can search by typing, preview the full text of a clip, paste it into the focused terminal, copy it back to your system clipboard, or clear the history.

This is the core of debugging together: copy a long error log, and your colleague picks it out of the shared clipboard and pastes it into their own terminal — no external chat, no "can you send me that?"

ShortcutAction
Ctrl+Shift+CShared clipboard
Ctrl+Alt+CYour device's clipboard history

Side panels

taiku's panels slide in beside your tiles for the things that don't belong in a terminal — who's here, what agents are doing, your connection health, and settings.

Opening the Activity, Users, Settings, and Network panels beside the tiled layout
ShortcutPanel
Ctrl+Alt+AActivity (notifications and agent events)
Ctrl+Alt+WUsers (who's in the session)
Ctrl+Alt+QChat
Ctrl+Alt+ETunnels (shared local previews)
Ctrl+Shift+SSettings
Ctrl+Shift+DNetwork info
Ctrl+Shift+UJump to an unseen terminal

The Network info panel breaks the connection down hop by hop — from you, to the server, to the shell — so you can see exactly where any latency is coming from.

Customize your shortcuts

Every built-in shortcut is rebindable. Open Settings → Keyboard (or press Ctrl+Alt+S for the full shortcut reference) and find the keyboard shortcuts list. Search for a command, click its binding, and press the new combination — the keys you press show live as you hold them. If a combination already belongs to another command, taiku flags the conflict so you don't shadow an existing binding by accident.

Overrides are saved per device. Use Reset to drop all of them and return every shortcut to its default.

Next steps

On this page