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 savedCopy Anchor Link

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). 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.

AccountCopy Anchor Link

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.)

AppearanceCopy Anchor Link

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.

BehaviorCopy Anchor Link

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.
• Keep routine toasts quiet: 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.

KeyboardCopy Anchor Link

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.

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.

AgentCopy Anchor Link

AI agent tracking: status badges and the session viewer, terminal highlighting, and the notification mode (sound, flash, both, or none). Notify me 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.

Model providers is where you bring your own model keys. An agent you run on taiku calls a model with whatever key this taiku holds, which is a key everyone here shares. Paste your own for a provider and your agents authenticate as you instead, so those calls go to your account with that provider. Each row says whose key pays for it: Your key, Shared key, or No key when nobody holds one and the provider will not answer. Remove a key at any time and your agents fall back to the shared one, where there is one.

taiku stores the key encrypted and never shows it again; every screen and every answer from the server names the variable, never the value. A provider you bring a key for uses only your key, so any endpoint this taiku had configured for that provider is dropped along with its credential.

Claude Code on your cloud boxes signs claude in on the cloud machines you own. Sign in runs Claude Code's own sign-in on your cloud box and opens Claude's page in taiku; the code that page shows goes in the field under the row. A token you already made with claude setup-token goes in with Add key. A desktop app older than Sign in shows only Add key until it updates. Every new shell you open on one of your cloud boxes then starts with Claude signed in to your subscription. taiku keeps the login and your shells borrow it. Once anyone else joins a session on a box, that box stops lending it for good, because everyone with a shell there can read the others' shells, and it can no longer run the sign-in either.

Codex on your cloud boxes shows whether taiku holds a ChatGPT login for codex on the cloud machines you own, and whose. There is no sign-in inside taiku: run taiku codex login on any computer with a browser, and the row shows that command, with a copy button, when there is no login or when OpenAI has refused the one taiku holds. Remove forgets the login and signs it out at OpenAI. Your shells borrow it the way they borrow the Claude login, and a box stops lending it once anyone else joins a session there.

VoiceCopy Anchor Link

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 desktopCopy Anchor Link

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 and target bitrate, under Viewing quality, are this device's preferences when it views a remote desktop; the host may lower them to fit its own limits. The codec is chosen per session. See Devices & remote access and Remote desktop.

Sharing & privacyCopy Anchor Link

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.

CloudCopy Anchor Link

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).

AdvancedCopy Anchor Link

API access 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.
• 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 zoneCopy Anchor Link

• 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.