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; this page is a map of what each one 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, press the new combination, and it's saved; taiku flags a conflict if the combination is already taken so you don't shadow another command. Use the search box to find a command by name, and Reset to defaults to clear all your overrides at once. These changes sync across your devices. (Hidden on mobile.)

Agent

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

The default stream quality — frame rate, target bitrate, and codec — when this device views another machine's desktop. The host may lower these to fit its own limits. See 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.