Configuration

Themes

atrium ships with eleven built-in themes and supports custom themes.

Custom themes

Place a JSON file in ~/.atrium/themes/ to add a custom theme. The file should follow this structure:

{
  "name": "my-theme",
  "type": "dark",
  "terminal": {
    "background": "#1e1e1e",
    "foreground": "#d9d9d9",
    "cursor": "#ffd044",
    "cursorAccent": "#000000",
    "selectionBackground": "#47474780",
    "black": "#000000",
    "red": "#f07178",
    "green": "#c3e88d",
    "yellow": "#ffd044",
    "blue": "#82aaff",
    "magenta": "#c792ea",
    "cyan": "#89ddff",
    "white": "#ffffff",
    "brightBlack": "#545454",
    "brightRed": "#f07178",
    "brightGreen": "#c3e88d",
    "brightYellow": "#ffd044",
    "brightBlue": "#82aaff",
    "brightMagenta": "#c792ea",
    "brightCyan": "#89ddff",
    "brightWhite": "#ffffff"
  },
  "chrome": {
    "surface": "#181818",
    "border": "#303030",
    "text": "#d9d9d9",
    "textMuted": "#848484",
    "accent": "#FFD044",
    "hover": "rgba(217, 217, 217, 0.1)"
  }
}

Select your theme from the Settings dialog.

Keybindings

atrium's keybindings default to iTerm conventions and are fully remappable.

Remapping keybindings

Open Settings and navigate to the Keybindings tab. Each binding shows the current key combination and action. Click to edit.

Action types

• send-text — Send raw text to the active PTY (e.g., escape sequences)
• uri-command — Dispatch an atrium:// protocol URI
• built-in — Built-in application actions (split, close, zoom, etc.)

App settings

Configuration is stored in ~/.atrium/config.json. Settings include:

• Updates — Check on launch, auto-install, channel (stable/beta), check interval
• Markdown editor defaults — View mode, font, font size, text alignment
• Workspace behavior — Confirm before closing AI sessions

All settings are accessible from the Settings dialog in the app.

Data directory

• Production: ~/.atrium/
• Dev builds: ~/.atrium-dev/

The data directory contains:

• config.json — App configuration
• adapters/ — Installed adapter manifests and scripts
• themes/ — Custom theme files
• state/ — Workspace and app state snapshots
• journal/ — Write-ahead journal entries