Settings

Open Settings from the toolbar or with Ctrl+Shift+S (macOS desktop app: Cmd+Shift+S). Settings open as a full panel with a list of sections down the side. On a phone, choose a section from the opening list and use the back button to return to that list. This page is a map of what each section controls and links to the guide that explains it fully.

Where settings are saved

Most settings are saved per device: they apply only to this browser or desktop install and don't follow you to another machine. A few are synced to your account and apply everywhere you sign in:

• Synced: your account profile (Account), keyboard shortcuts (Keyboard), and cloud workspace preferences (Cloud).
• Per device: everything else, including Appearance, Behavior, and most of Advanced (the indexing ignore list and default tunnel port). Your API key belongs to your account; only the show / copy / regenerate controls live in Settings.

Per-device settings never affect other participants in a shared session.

Account

Your identity, profile, and plan: display name, avatar, links, whether your public profile is visible, and whether others can find you by username search. (Hidden in the local desktop app, which has no account.)

Appearance

How the workspace looks:

• Theme: the color theme.
• Animate transitions: turn tile animations on or off.
• Tiles: titlebar style and whether unfocused tiles are dimmed.
• Toolbar: position (top or left) and visibility (always, or on hover).
• Terminal: a few terminal display options.

Behavior

How tiles and terminals respond to you:

• Focus on hover: move the keyboard focus to whatever tile your pointer is over, without clicking.
• Single-click to open: open paths, files, and worktree / branch links in terminal output with one click instead of a double-click.
• Open links in native browser: (desktop app only) open non-localhost links in your system browser instead of an in-app tile. Localhost links always open as tunnel tiles.
• Quiet mode: route routine toasts (Copied, Saved…) to the Activity log instead of popping them over the UI. Errors and actionable toasts still show.
• Preview arrow-key cycling: whether ← / → in the file previewer stays within the current file's type or walks every sibling in the folder.
• Tiles: how small tiles may get before the layout stops shrinking them.

Keyboard

Rebind any editable command to your own keys. Click a shortcut and press the new combination. Use the search box to find a command by name. These changes sync across your devices.

A key that is already taken can't be saved. taiku names the command that owns it and offers to hand the key over, either clearing the other command or clearing it and putting it straight into rebinding so you can give it a new key in the same motion. Two spellings of the same combination count as the same key, so Shift+Cmd+K and Cmd+Shift+K won't both be accepted.

A few keys belong to things that can't be rebound, such as Cmd+= and Cmd+- for terminal font size. Those are named too, but there is nothing to hand over, so pick a different key.

Chords are a leader key followed by a second key, tmux or Raycast style. Press Record a chord, press the leader, then press the second key. While a leader is waiting, taiku shows it at the bottom of the screen; it clears itself after about a second and a half, or on Escape.

Single keys with no modifier are offered for commands that work anywhere, such as the command palette. They never fire while you're typing: a terminal, a text field, an editor, a remote desktop or an embedded page always gets the key first. The same holds for keys that type a character rather than command the app, which is why they are offered in the same places: Shift+A is a capital A on every keyboard, and on a Mac Option+G is ©.

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

AltGr can't be part of a shortcut either: on a German, French, or other layout with a third-level key it types a character, and taiku says so when you try to record one. Windows and Linux report AltGr as Ctrl+Alt, so on those layouts the Ctrl+Alt+… defaults don't fire either; rebind any of them you want to a Ctrl+Shift+… combination.

Because your rebindings sync across your devices, taiku only offers keys that work on all of them. Alt+G is turned down for a command scoped to a terminal or an editor for that reason: on a Mac it types ©, so the binding would be silent on exactly the surface the command acts on. The same key is still offered for commands that work anywhere.

Some commands answer to more than one key out of the box. Close Focused Tile takes both Cmd+Shift+Q and Cmd+Shift+W, for instance. Rebinding one of those replaces the whole set with the single key you press; the editor tells you which key you're giving up, and Reset to default brings it back.

Plugin shortcuts are listed under Plugins and are yours to change. A plugin's declared key is only a default, so your choice survives the plugin updating itself, and Reset to plugin default puts it back. Clear shortcut leaves a command with no key at all. If installing or updating a plugin brings in a key something else already uses, taiku tells you at that moment and names both, so a shortcut never changes hands quietly.

Reset commands clears your builtin rebindings, and Reset plugin keys clears your plugin ones, so neither wipes the other.

On a phone the list is read-only, in either orientation, since recording a shortcut needs a hardware keyboard. A shortcut you saved for a plugin that doesn't run on the device you're looking at is shown as unavailable here rather than offered for deletion, so you can't lose it from the wrong machine.

Agent

AI agent tracking: status badges and the session viewer, terminal highlighting, and the notification mode (sound, flash, both, or none). Notifications when taiku is closed adds background browser notifications for workspace and sync updates with no taiku tab open; on iPhone and iPad, add taiku to your Home Screen first. See Agents → Notification configuration.

Voice

Pick the microphone for voice dictation and test it, and choose the speech-to-text engine, automatic, cloud only, or on-device (with an on-device model picker).

Remote desktop

In the desktop app, turn Allow remote access to this device on or off. A fresh install leaves it off until you opt in. The permissions needed for screen capture, remote input, and whole-machine file access appear under Permissions & access when remote access is enabled.

The session Settings overlay also controls whether remote-desktop connections ask for approval, require a password, or start automatically. Frame rate, target bitrate, and codec are viewer preferences; the host may lower them to fit its own limits. See Devices & remote access and Remote desktop.

Sharing & privacy

How your sessions are shared (live view only, or letting viewers browse files) and what leaves this device, including offline mode. On the local desktop app this section is labeled Privacy & network. See Share a session.

Cloud

Preferences for cloud workspaces, synced across browsers when you sign in. (Hidden in the local desktop app.)

• Desktop idle teardown: how long a cloud desktop keeps running after the last viewer disconnects, in seconds. Set 0 to tear it down immediately. Default is 300 (5 minutes); maximum is 86400 (24 hours).

Advanced

API access, tunnels, and indexing:

• API key: show, copy, or regenerate the key that links CLI sessions to your account. Regenerating it immediately invalidates the old key. See taiku.
• Default tunnel port: the port pre-filled when you open a new tunnel.
• Indexing ignores: folder names skipped by tag pages, diagnostics, autocomplete, and recursive path lookup. Add an entry by typing it and pressing Enter, comma, or space; Reset defaults restores the built-in list.

Danger zone

• Log out: sign out of this account on this device.
• Delete account: permanently remove your account along with all your data, sessions, and devices. You're asked to type your username (or email) to confirm; this cannot be undone.