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.

Click to scrub

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
Click to scrub

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+1-9. 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.

Click to scrub

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. Inside a browser tile the same key reopens the browser tab you just closed, the way it does in a browser.

Click to scrub

To rearrange your layout, drag a tile by its titlebar and drop it onto another to swap the two.

Click to scrub
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+1-9.

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.

Click to scrub

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.

Click to scrub

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+1-9. Create a new page with Ctrl+Shift+\.

Click to scrub

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.

Click to scrub

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?"

Click to scrub
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.

Click to scrub
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, and so is every shortcut a plugin brings with it. 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.

A combination that already belongs to another command can't be saved. taiku names the command holding it and offers to hand the key over, so you never end up with two commands quietly fighting over one shortcut. It doesn't matter how you spell it: Shift+Cmd+K and Cmd+Shift+K are the same key.

Two other shapes are available:

  • Chords, a leader key then a second key. Press Record a chord, press the leader, then the second key. The waiting leader is shown at the bottom of the screen and clears itself if you don't follow through.
  • Single keys with no modifier, for commands that work anywhere. These never fire while you're typing; a terminal, text field, editor, remote desktop, or embedded page always gets the key first. Keys that type a character rather than command the app are treated the same way, since Shift+A is a capital A and on a Mac Option+G is ©.

The Windows key (Super on Linux) can't be part of a shortcut; your window manager owns those. On a Mac, Ctrl works in place of Cmd everywhere.

Keyboard layouts with AltGr

On a German, French, or other layout with a third-level key, AltGr types a character, so it can't start a shortcut. taiku says so when you try to record one. On Windows and Linux the system reports AltGr as Ctrl+Alt, so the Ctrl+Alt+… defaults are unavailable on those layouts too. Rebind any command you want there to a Ctrl+Shift+… combination.

Overrides sync across your devices, so taiku only offers a key that works on all of them. That's why Alt+G is turned down for a command scoped to the terminal or an editor: on a Mac that keystroke types ©, so the binding would be silent on exactly the surface the command acts on.

Reset commands returns the built-in shortcuts to their defaults, and Reset plugin keys does the same for plugin ones.

When you install or update a plugin that wants a key something else already uses, taiku tells you and names both, rather than letting the two quietly fight over it. Your own choice always wins: a plugin's declared key is only a default, so an update can never take a rebound key back.

Next steps

On this page