Skip to contentSkip to content
Umber
Download
Umber app iconv0.3.0

Umber

The native Mac terminal built for AI agents.

Swift and AppKit. No Electron overhead. Your agents get the full machine.

Download v0.3.0GitHub →
Umber running agent-afk with sidebar file tree and syntax-highlighted output

What’s New

v0.3.0

August 25, 2026 — eight measured themes, system appearance following, split-pane dimming, and typography controls.

Community Themes

Catppuccin Mocha, Nord, and Dracula — ported verbatim from their upstream specs and gated by the contrast harness (474 assertions).

"preset": "catppuccin-mocha"

Auto Dark / Light

Follow macOS appearance automatically. Umber switches between a dark and light palette when System Settings changes.

"preset": "auto"

Split-Pane Dimming

Unfocused split panes dim to visually distinguish the active pane. Fully configurable.

"unfocusedPaneOpacity": 0.85

Typography Controls

Font dilation for white-on-black text (the same technique Terminal.app uses) and configurable line height.

"fontThicken": true, "lineHeight": 1.2

Terminal Padding

Configurable inner margin around terminal content with seamless background color matching.

"padding": 8
Download v0.3.0Full release notes →

Built for AI agents

The best terminal agents run in your shell, not in a browser. Umber gives them a fast, native host that stays out of their way.

Claude Code

Anthropic's terminal-native coding agent. Runs entirely in your shell.

Codex

OpenAI's CLI agent for code generation and multi-file edits.

Agent AFK

Autonomous agent runtime with daemon, Telegram, and REPL surfaces.

Hermes

Terminal agent framework with tool use and conversation memory.

agents run in terminals — the terminal shouldn't compete with them for CPU, RAM, or your attention.

OSC 133 command tracking — see which agent task succeeded or failed at a glance, across every tab.

Split panes — run an agent and its supervisor side by side. ⌘⇧\ to split, ⌘⇧H/J/K/L to navigate.

Dual engines — SwiftTerm or libghostty, same window. Pick the emulator that fits the workload.

Features

No AI built in — on purpose. The intelligence belongs to your agent, not the terminal chrome.

Zero-Overhead Host

Swift and AppKit — no Electron, no V8, no renderer process. Your agents get the RAM. Launches instantly and stays out of the way.

Agent Workspaces

One Space per project root. Multiple agent sessions inside. Switch projects without losing context — real macOS window tabs, not a custom layer.

Sidebar File Tree

Browse files alongside the terminal with git status badges on every row. See what your agent changed without leaving the window.

Measured Themes

Eight palettes tested for readability — every color verified against contrast standards. Includes Catppuccin Mocha, Nord, and Dracula. Long sessions reading agent output stay legible.

GPU or CPU Rendering

Switch between Metal (GPU-accelerated) and Core Text rendering with one config line and ⌘R. High-throughput agent output stays smooth.

Agent Status at a Glance

Background tabs show a green dot when a command succeeds, red when it fails. OSC 133 shell integration — no polling, no tab switching.

More than a terminal

Open files from the sidebar into editor tabs that sit alongside your terminals. Syntax highlighting, code folding, symbol outline, multi-cursor — enough to review and edit without switching apps.

Agent workspaces in action

Each project gets its own Space with a full file tree, git status, and as many terminal tabs as you need. Your agents see the same directory structure you do.

  • Sidebar follows the focused shell's working directory automatically
  • Git status badges on every file — staged, modified, untracked, deleted
  • Double-click any file to open it in the built-in editor
Umber workspace showing a project file tree with multiple terminal tabs and git status indicators

Edit without leaving the terminal

Open files from the sidebar directly into a syntax-highlighted editor tab. Review what your agent wrote, make a quick fix, and get back to the terminal — no app switching.

  • Syntax highlighting for 23 languages with tree-sitter grammars
  • Line numbers, indent guides, and a column guide at 80 characters
  • Auto-indent, bracket matching, and indent-rainbow coloring
Umber editor tab showing syntax-highlighted TypeScript alongside the terminal

Syntax Highlighting

23 languages out of the box — Swift, TypeScript, Python, Rust, Go, Markdown, and more. Tree-sitter grammars with scope-aware token coloring.

Command Palette & Symbols

⌘⇧P fuzzy-filters every app command. ⌘⇧O jumps to symbols. ⌘L goes to a line number. All keyboard-driven, no mouse required.

Code Folding & Navigation

Indent-based fold and unfold with ⌘⌥[ and ⌘⌥]. Sticky scroll keeps the enclosing scope visible. Bracket pair highlighting.

Multi-Cursor Editing

⌘D selects the next occurrence. Full multi-cursor support for parallel edits across a file — the same muscle memory as VS Code.

Themes

Five palettes ship out of the box. Each is gated by 345 contrast assertions.

umber ~/Projects/umber
$ swift run Umber
Build complete (0.3s)

Install

Requirements:macOS 14+
Download Umber v0.3.0

Universal binary · 1.7 MB · signed & notarized

or

Keyboard Shortcuts

Spaces & Documents
Spaces & Documents keyboard shortcuts
ShortcutAction
⌘NNew Space (window tab)
⌘TNew document in current Space
⌘⇧[Previous Space
⌘⇧]Next Space
⌘⌥←Previous document
⌘⌥→Next document
⌘1–⌘9Jump to document by index
View & Splits
View & Splits keyboard shortcuts
ShortcutAction
⌘BToggle sidebar
⌘⇧\Split pane right
⌘⇧H/J/K/LFocus pane left / down / up / right
⌃⌘FFull screen
⌘RReload config
⌘,Open Settings
Font Size
Font Size keyboard shortcuts
ShortcutAction
⌘+Zoom in (persists across tabs and relaunches)
⌘-Zoom out
⌘0Reset zoom to config font.size
Line Editing
Line Editing keyboard shortcuts
ShortcutAction
⌘⌫Delete to start of line (^U)
⌘⌦Delete to end of line (^K)
⌘←Jump to start of line (^A)
⌘→Jump to end of line (^E)
⌥←Jump back one word
⌥→Jump forward one word