Settings & config file

One file for everything

All of Seedmux's settings live in a plain text file, ~/.seedmux/config.toml — fonts, themes, window transparency, the hotkey, shortcuts, Agent Team, updates, language. Every option is listed with a short explanation.

• Edit it with anything — your editor, or the agent in a pane. Save, and the change applies immediately.
• The Settings window and the file stay in sync. Change one, the other follows.
• Keep it in your dotfiles. If config.toml is a symlink, Seedmux writes through the link.
• Per-machine overrides go in config.local.toml next to it.

Look and feel

• Settings › Appearance — window transparency and blur, terminal font, colour scheme, chat text size, the Dynamic Island.
• Custom colour schemes, or import one from iTerm2.
• Space colours — each space has its own palette that tints the sidebar, the window and the terminal together.
• GPU rendering with Ghostty's renderer, inside a native AppKit window.

English & 中文

Seedmux is fully bilingual, and you can pick the font used for Chinese, Japanese and Korean text. Input methods work as you'd expect, including voice input.

Your shell

New tabs open your login shell — zsh, bash or fish.

Other pages in Settings

Agent	Per-agent switch for skipping permission prompts
Claude	Extra environment variables for Claude Code started from Seedmux
Agent Team	Turn Agent Team on or off, keep worker panes, edit its instructions
Phone	Pair your iPhone, background service status, relay address
Remote Hosts	Your servers and paired machines
Spaces	Names, icons and folders for each space
Terminal	tmux status, Recover Missing Tabs
Diagnostics	A checklist for when your phone connects but shows no sessions
Privacy & Permissions	One switch for anonymous usage statistics