Appearance: text size, code fonts, UI scale, themes, and wallpaper
Set universal text size, shared code typography, UI scale, icon pack, spacing presets, sidebar layout, live theme switching, and an image or video wallpaper behind the mosaic.
atrium separates themes (colors), code typography (terminal, editor, diff, and transcript code), markdown prose typography, interface size (chrome and text together), and text size (an extra text-only multiplier).
UI scale
The app-wide interface size multiplies every chrome dimension — padding, gaps, icon sizes, borders, and radii — and keeps text proportional to that chrome.
- Settings → Appearance → Interface size — slider from 50% to 200%, with
−/+buttons for precise steps. Dragging previews immediately and commits the persisted value when you release. - Keyboard shortcuts
Cmd+=/Cmd+-/Cmd+0step zoom in / out / reset. - Persisted as
uiScalein app state; applied across all projects. - Components use
scaledPx()for React inline styles andvar(--ui-scale)for CSS, so custom themes and third-party components inherit the scale automatically. - Scaled surfaces include the launcher overlay (with the xxs tile size), the markdown editor (both the prose layer and the contenteditable font-size), every modal (launch dialogs, confirms, scaffold modals, dictation overlay), the Library / Vault layout, the tab close button, and the per-row chrome of the skills and profile dialogs. Modals also grow with the window via
clamp(min, Xvw, max)instead of staying pegged at hardcoded widths.
zoom or inverse-zoom on the mosaic. If you come from an older version that did, the UI scale value migrates; hand-edited zoom rules in custom themes should be removed.
Text size
Settings → Appearance → Text size adds a 50%–200% multiplier to atrium's text without applying the same multiplier to icons, borders, pane gaps, and other explicitly sized chrome. Interface size and text size compose, so the effective size is base font size × interface size × text size.
Text size applies to interface text and Markdown prose. Code has its own font-size control below: terminal output, Monaco, diffs, and code blocks do not grow with Text size. Inline code inside a prose sentence follows that sentence. Websites inside browser panes keep their own page sizing, and saved user-authored drawing text is left unchanged.
Code typography
Under Settings → Appearance → Code, one compact set of controls applies to terminal output, file editors, source-control and review diffs, markdown code and source mode, transcript code blocks, tool output, and code snippets:
- Font — a dropdown of detected monospace fonts. The system is scanned with font-kit on launch and known monospace families are cached.
- Font size (default 11).
- Line spacing — multiplier on each code surface's established line height.
- Letter spacing — additional horizontal padding per glyph.
- Font ligatures — toggle.
effective code size = base code size × interface size. These preferences remain stored under config.terminal in config.json, so existing terminal typography carries forward automatically.
Terminal appearance
Terminal-only controls remain under Settings → Terminal:
- Cursor style —
block/underline/bar. - Cursor blink — toggle.
- Scrollback lines — how many lines of history xterm retains.
- Padding — pixel padding inside the terminal pane.
- Background opacity —
0.0to1.0.
config.terminal in config.json.
Markdown editor font
Use the rich-text Markdown editor's formatting toolbar, including More options when the pane is narrow:
- Font — choose from the font menu; Default follows the app's font.
- Font size (default 14).
- Text alignment —
left/center/right/justify. - Book view — fixed-width centered column for long-form writing, with configurable width and side margin.
config.markdown_editor; changes apply to open Markdown editors. The configured font size is multiplied by Interface size and Text size. Source mode follows the shared code typography settings.
Activity sidebar density
Changes how much per-card detail the sidebar shows.
- Full — status + last event + progress + tool call summary.
- Semi-compact — status badge and last event time.
- Compact — status dot and adapter accent only.
- Ultra-compact — the tightest rows, fitting the most agents on screen.
Icon pack
The whole chrome icon set is switchable at runtime under Settings → Appearance:
- Hugeicons — the default.
- Lucide.
- Phosphor (duotone).
Four independent switches can make chrome icons, adapter marks, favicons, and emoji monochrome. Chrome covers pane, project, and file-type glyphs; leaving the other switches off preserves brand and user-content color where it carries meaning.
Layout spacing
Spacing presets control every chrome gap at once — pane padding, sidebar insets, header spacing, tray gutters — so you can tighten the whole app for a dense display or loosen it for a large one without hunting through individual settings.
Sidebars
Either sidebar can mount Home, Activity, File Tree, Timeline, or Skills & Agents. The right header is the mode switcher; the left View options menu has Change view. Picking a view that's open on the other side swaps them. See Panes overview → Pane navigator.
Cmd+B— toggle the left sidebar.Cmd+Shift+A— toggle the right sidebar.Cmd+Ctrl+1throughCmd+Ctrl+5— select Home, Activity, File Tree, Timeline, or Skills & Agents on the right. On Windows, useCtrl+Alt+1throughCtrl+Alt+5.Cmd+Shift+2— toggle both side sidebars.Cmd+Shift+1— toggle those plus the room bar.Ctrl+B— collapse the rooms sidebar;Ctrl+Tflips this project between the rooms sidebar and the horizontal tab bar.- `
Cmd+Shift+`` — zen mode: all chrome hidden, only the mosaic.
Pane header breadcrumbs optionally show the workspace, project, and wing path ahead of every pane title. Toggle them under Settings → Appearance → Chrome; the path is especially useful when several visible workspaces or remote locations contain similarly named rooms.
Tab layout diagrams
Every room strip shows a miniature color-coded diagram of that room's pane layout. The diagram reflects split orientation and pane-type accent colors — notepad amber, diff-review teal, browser blue, git red, editor neutral — so you can identify "the room with a split between the browser and the editor" at a glance.
Live theme switching
Switching themes from Settings → Theme, atrium theme switch <name>, or the system light/dark trigger now applies to the running app immediately — no reload required. Every pane reads from the shared CSS custom properties, so the swap flows through chrome, panes, sketches, and overlays in one tick.
Wallpaper
Set a full-window background behind the mosaic. When a wallpaper is active, surfaces go translucent, frosted-glass so the image shows through a single layer per surface — git diffs, sidebar items, activity cards, kanban boards, and composers all composite over it rather than painting opaque panels.
Supported sources:
- Image (PNG, JPG, …) or animated GIF.
- Video (mp4, webm, mov) — rendered as a hardware-decoded
<video>, so it animates smoothly at a fraction of the CPU a CPU-decoded GIF would cost. Prefer a short looping video over a heavy GIF. - See through the window (macOS and Windows) — makes the actual desktop and apps behind atrium visible through the window, without choosing an image. Surface opacity, Gap opacity, and Background blur control how much shows through and how frosted it looks. On Windows, Background blur is an on/off frost (Windows' Acrylic) and needs Windows' Transparency effects, which are on by default.
Scope
How far the wallpaper reaches is configurable:
- Whole app — panes, sidebars, menus, room bar, and gaps become translucent.
- Panes only — it shows through the mosaic's panes.
- Panes + sidebars — it shows through both.
Turning the wallpaper off keeps its source and tuning for next time. Remove clears the selection.
Pane lights
An opt-in visual layer that wraps adapter panes in an activity-reactive glow, color-coded per adapter, so a busy pane visibly lights up. The motion is weather-like — traveling wavefronts and volumetric depth that react to each pane's activity. Lights only animate for on-screen panes, so the effect stays cheap.
Enable Pane lights under Settings → Appearance. It's off by default.