Appearance Customization

  • Desktop app
  • All plans

What it does

Makes the app look the way you want: light, dark or system theme, the colors of the surfaces themselves (app background, panels and sidebar: built-in palettes or your own colors), an accent color applied to buttons, borders, focus rings and active states, replaceable interface fonts, a global zoom for tired eyes, and a "calm rendering" switch that stops decorative animations. Agents get a custom avatar too: upload an image or pick one of the role portraits. Terminal panes have their own theme and font choice. On the phone, a Text size setting makes all text larger, terminal and conversation included.

Where to find it

  • Settings > Appearance: Theme, Surfaces, Accent color, Your messages, Fonts, Zoom, Agent cards, Focus borders, Motion.
  • Footer: the Light / dark switch toggles the theme without opening Settings.
  • Footer, left of the Settings button: a zoom chip ("Interface zoom: N%") appears only while the zoom is not 100%.
  • Settings > Terminal: Theme (Follow app theme / Always dark / Always light) and Font for terminal panes.
  • Agent avatar: open an agent's Edit Agent modal, Customize avatar.
  • Phone: Settings > Appearance > Text size.
  • For developers: the color values themselves (every surface palette in light and dark, the Peach accent, status colors, diff colors, font stacks, focus border widths) are published as JSON at https://agentsroom.dev/design-tokens/v1.json, with its schema at https://agentsroom.dev/design-tokens/v1.schema.json.

How to use it

  1. Theme: Settings > Appearance > Theme, choose Light, Dark or System. A fresh install starts on System (it follows the computer's light or dark mode), except on Linux where it starts on Dark, since many Linux desktops report no preference. An install that never picked a theme before this default keeps the Dark theme it always had.

  2. Surfaces: Settings > Appearance > Surfaces, pick a palette: Warm (the default), Neutral (plain grays), Dim (softer contrast and less glare) or High contrast (black or white surfaces, stronger text and borders). Hover a palette to preview it, click to apply. Each palette has a light and a dark version and follows the Theme. Custom lets you choose the Background, Panels and Sidebar colors yourself, each with the app's color picker; the colors you set apply to the theme currently shown, so switch Theme to set the other one. Dark colors are kept dark and light ones light, and the text color adapts on its own so it stays readable. Reset to default returns to Warm.

  3. Accent: click the color button to open the app's color picker (the same one as for accounts, agents, projects and backlog columns): pick a color of its palette, or any color with the color wheel or a hex code. The default is Peach; Reset to default returns to it. Since 2026-10-23 the former accent presets are no longer offered (an accent already set to one keeps it).

  4. Your messages: Settings > Appearance > Your messages, choose Accent (the default: your messages in the conversation view are filled with the accent color) or Neutral (a quiet surface color of the current palette, with the normal text color). The accent stays on buttons, borders and focus rings either way.

  5. Fonts: for the Headline font, the Body font, the Writing font (composer, chat, prompt editors) and the File names font (file names and paths in the file tree, Changes, diffs and commits), search a Google Fonts family by name, or upload a .ttf / .otf / .woff / .woff2 file. Downloaded fonts are kept locally, so they keep working offline. Reset restores the stock font. Some slots also offer Included faces, applied in one click without a download: for file names, Iosevka, Geist Mono and IBM Plex Mono. File names use Geist by default.

  6. Zoom: Zoom in / Zoom out / Back to 100%, or Cmd/Ctrl + and Cmd/Ctrl - anywhere, Cmd/Ctrl 0 to reset. The zoom applies to every AgentsRoom window and is remembered. While it is not 100%, the footer shows the level; click that chip to go back to 100% (same as Cmd/Ctrl 0).

  7. Agent cards: Settings > Appearance > Agent cards, choose Standard or Large. Large cards show a 48 px avatar and three lines of text (title, role, last message) for open agents; hovering still swaps the text for the action buttons. The interface zoom does not change.

  8. Motion: Calm rendering turns decorative loops (glows, sheens, status pulses) off; loaders keep spinning. Worth it on very large or high-refresh displays. Without it, the animations of a working agent already run at about 15 frames per second, and stop while you are in another app: status text and elapsed time keep updating.

  9. Phone text size: Settings > Appearance > Text size, tap + (Larger text) or - (Smaller text) to step through 100, 115, 130, 150 and 175%. The whole app resizes at once and the preview under the buttons shows the result. Back to 100% appears while the size is not 100%.

Avatar: upload (cropped to a square) or pick a preset portrait, preview, then Save. The avatar travels with the agent when it is shared.

Settings

  • surfacePalette (global, Settings > Appearance > Surfaces): { presetId } with default (Warm, the default), neutral, dim, contrast, or custom plus custom: { dark: { background, panel, sidebar }, light: { ... } } in #rrggbb. Saved on the account, so another computer signed in to the same account gets the same palette. Desktop only.
  • userBubbleStyle (global, Settings > Appearance > Your messages): accent (default, your conversation messages filled with the accent color) or neutral (a quiet surface color of the theme). Saved on the account; the phone follows it in its conversation view.
  • agentCardSize (global, Settings > Appearance > Agent cards): standard (default, two lines, 32 px avatar) or large (three lines, 48 px avatar). Applies to open agent rows, local, remote and cloud; inactive rows keep their compact look. Saved on the account. Desktop only.
  • focusBorder (global, Settings > Appearance > Focus borders): standard (default, 2 px), thin (1 px for the active pane frame and the input fields) or none (No frame: no accent frame around the active pane or the focused terminal, the pane is still marked by its highlighted name badge; input fields stay at 1 px so they remain visible). Saved on the account. Desktop only.
  • projectTilesPlacement (global, Settings > Appearance > Open projects): titleBar (default) or sidebar. Moves the row of open projects (project icons with their status badges, the project name and its Open folder / Statistics / Project settings buttons) between the title bar and the top of the left column, the earlier layout. Keyboard shortcuts Cmd/Ctrl+1…9 follow the row wherever it is. Saved on the account. Desktop only.
  • uiZoom (global, Settings > Appearance > Zoom): zoom factor, 0.75 to 2, 1 = 100%.
  • calmRendering (global, Settings > Appearance > Motion): stop decorative animations; off by default.
  • disableHardwareAcceleration (global, Settings > Appearance > Rendering > Disable hardware acceleration): draw the interface on the processor instead of the graphics card; off by default. Takes effect at the next launch (Restart now is offered).
  • terminalThemeOverride (global, Settings > Terminal): auto, dark or light for terminal panes.
  • terminalFontFamily (global, Settings > Terminal): terminal font id, empty = IBM Plex Mono.
  • Theme mode (light / dark / system), accent and interface fonts are stored on this machine only and are not exposed as settings keys.
  • Phone Text size is stored on the phone only, and is not a settings key either (nothing to set over MCP).

Agent tools (MCP)

  • settings_set on surfacePalette, userBubbleStyle, agentCardSize, focusBorder, projectTilesPlacement, uiZoom, calmRendering, disableHardwareAcceleration, terminalThemeOverride, terminalFontFamily.

Providers

All providers, no difference, with one exception: Codex reads the terminal colors only once, when it starts. After a switch between light and dark, a running Codex keeps its old input background while the text follows the new theme, so what you type can become unreadable. Its terminal then shows a Theme changed banner with Restart (restarts the CLI and picks the conversation back up) and Later; Later is remembered for that theme, and switching again offers it once more.

Mobile

The phone has its own Settings > Appearance with Auto, Light and Dark (Dark keeps agent output on a real terminal background), and Text size: 100, 115, 130, 150 or 175%, applied on top of the text size set in the phone's own settings (iOS Larger Text, Android Font size), so 100% means exactly what the phone says. Your messages follow the desktop's Your messages setting (Accent or Neutral) in the phone's conversation view. Surface palettes, accent and fonts are desktop only (file names on the phone use its text font, with no setting), and so is the desktop zoom, which the phone replaces with Text size (it scales the text, not the layout); the phone always shows agents with their role portrait.

Limits

  • Theme mode, accent and fonts are machine-local: they do not follow your account to another computer. The surface palette does.
  • Terminal panes keep their own colors (Settings > Terminal > Theme): a surface palette does not repaint the terminal background.
  • A picked accent uses the same color in light and dark mode (only the default Peach is tuned per mode).
  • Fetching a Google Font needs an internet connection once; nothing else is sent.
  • Chinese, Japanese, Korean, Arabic, Hindi and Thai interfaces download a matching Noto Sans face on demand, piece by piece, and keep it on disk. Offline on the first launch, the system font is used instead. Not on mobile, where the system font already covers these scripts.
  • On Windows and Linux, Ctrl + may need Ctrl = (without Shift) depending on the keyboard layout; the menu items always work.
  • Phone text size is per device and does not follow your account. The terminal keeps at least 40 columns, so on a narrow phone it stops growing around 130% while the conversation view keeps growing; the terminal also follows the phone's own text size when that is above 100%.

Common questions

  • After switching to light or dark, the text I type in Codex is invisible. Codex keeps the colors it saw at launch. Click Restart on the Theme changed banner of its terminal: the conversation resumes with the new theme.
  • Can I change the background color of the panes and the sidebar, not just the accent? Yes: Settings > Appearance > Surfaces. Pick Neutral, Dim or High contrast, or Custom to set the background, panel and sidebar colors yourself, separately for light and dark.
  • Is there a high contrast theme? Yes: Settings > Appearance > Surfaces > High contrast, in light and dark.
  • Can I make only agent cards larger? Yes: Settings > Appearance > Agent cards > Large. Cards get a bigger avatar and three lines of text, the rest of the interface keeps its zoom. It replaces the earlier "Agent card size" percentage, which zoomed the cards and made their buttons overlap.
  • The border around the active pane is too thick, can I make it thinner or remove it? Yes: Settings > Appearance > Focus borders. Thin draws the frame and the input fields at 1 px, No frame removes the frame around the active pane (its name badge stays highlighted). Standard is the original 2 px.
  • Can I put the open project icons back in the left column? Yes: Settings > Appearance > Open projects > Left column. The row of open projects returns to the top of the left column, with each project's status badge and one click to switch; Title bar puts it back at the top of the window.
  • Can I keep the terminal dark while the app is light? Yes: Settings > Terminal > Theme > Always dark.
  • The text is too small. Desktop: Settings > Appearance > Zoom, or Cmd/Ctrl + repeatedly; it is remembered across launches. Phone: Settings > Appearance > Text size (or the phone's own text size, which the app already follows).
  • Noise or "frost" creeps across the window and text garbles until I hover it. That comes from the display driver. Turn on Settings > Appearance > Disable hardware acceleration and restart: the interface is then drawn on the processor.
  • AgentsRoom makes my GPU work hard on a large or high refresh rate screen. Turn on Calm rendering (Settings > Appearance > Motion): decorative animations stop, loaders keep spinning.
  • Why did the rotating halo of a working agent become a still ring? No AgentsRoom window has focus: animations rest to save battery and heat, and resume when you come back. The ring means the agent is still working; its status and elapsed time stay up to date. Calm rendering shows the same ring.
  • Why did AgentsRoom open in light mode? A new install follows the system theme, walkthrough included, so a Mac or Windows PC in light mode opens AgentsRoom in light. The walkthrough lets you choose Follow the system, Day or Night. Pick Dark in Settings > Appearance > Theme, or use the footer's light / dark switch.
  • Is my accent color sent anywhere? No, it is purely local.
  • Where can I get the exact colors of AgentsRoom for my own app? From https://agentsroom.dev/design-tokens/v1.json: palettes holds Warm (default), Neutral, Dim and High contrast (contrast), each in dark and light; accent.presets.peach the default accent; status the status colors and statusVocabulary which one goes with Needs you (error), To review (success) and Working (warning); diff the added / removed line colors; fonts the stacks of the Headline, Body, Writing and File names slots; focusBorder the widths. Colors are #rrggbb, or #rrggbbaa for a tint. The values are released under CC0 1.0 (free to use, no attribution needed); the AgentsRoom name, logo and mascot are not. Within v1, keys are only ever added, and revision changes whenever a value does. To follow the theme the user picked, live, read GET /v1/appearance of the Local status API.
  • The zoom chip appeared in the footer, what is it? The interface is zoomed (often a Cmd/Ctrl + pressed by accident). Click the chip to return to 100%.
  • File names look different than before, can I change them? Yes: Settings > Appearance > Fonts > File names font. Iosevka, the former narrow face, is still one click away under the included faces.
  • Can I use my company font? Yes, upload the font file in Settings > Appearance > Fonts.
  • My accent color is fine on buttons but too loud behind my own messages. Can I change that? Yes: Settings > Appearance > Your messages > Neutral. Your messages then sit on a quiet surface color of the theme, the accent stays on buttons and borders, and the phone follows.