Manor

---

Highlights

Projects & Workspaces Organize repos into projects. Manage git worktrees as workspaces. Switch context in a keystroke with Cmd+K.
	Splits & Tabs Split horizontally or vertically. Navigate panes and tabs with keyboard shortcuts. Layouts persist across restarts.
GitHub & Linear PR status badges appear next to branches. Browse your Linear issues and jump straight into the right project.
	AI Agent Awareness See when Claude Code or other agents are active in a terminal — no more wondering which tab is running what.
Theming Per-project themes with hundreds of options. Matches your Ghostty config automatically.

Features

• Terminal emulation — Powered by xterm.js with WebGL rendering, search, image support, and clipboard integration
• Tabs and pane splitting — Split horizontally (Cmd+D) or vertically (Cmd+Shift+D), navigate with keyboard shortcuts
• Projects and workspaces — Organize repositories into projects, manage git worktrees as workspaces
• Session persistence — Terminal sessions survive app restarts via a background daemon process
• GitHub integration — View PR status badges next to branches
• Linear integration — Browse assigned issues and match them to projects
• Built-in browser — Preview dev servers in a side pane with full navigation, zoom, and an element picker that captures HTML, styles, and accessibility info — point at anything and feed it straight to your AI agent
• Named previews — Dev servers automatically get stable URLs like myapp.localhost instead of localhost:3000 — zero config, powered by portless
• Port scanner — Detect running services across your workspaces
• Branch and diff watching — Track git branch changes and uncommitted line counts
• AI agent detection — Visual indicators when Claude Code or other agents are active in a terminal
• Theming — Per-project themes with hundreds of options; matches your Ghostty config automatically
• Command palette — Quick access to projects, workspaces, and actions via Cmd+K
• Remote control — Check on your agents from a phone, and get pushed a notification when one is blocked. Off by default; read what it exposes before turning it on

---

Getting Started

Download

Download the latest .dmg (Apple Silicon) — or browse all releases.

Prerequisites

• Node.js (LTS recommended)
• pnpm — package manager

Native dependencies (node-pty, electron) are rebuilt automatically during install.

From source

git clone https://github.com/orrybaram/manor.git
cd manor
pnpm install
pnpm dev

Agent CLI

Every Manor terminal has the manor command on PATH, generated from the same tool definitions that power the MCP server. Agents running inside Manor should prefer the CLI to avoid loading the tool roster into context.

manor --help
manor list-projects
manor create-folder --name Backlog
manor set-workspace-folder --workspace-path <path> --folder-id <id>
manor git-diff

See ADR-170 and ADR-171 for architecture.

Distribution

pnpm package produces a signed, notarized .dmg/.zip for release. It requires Apple Developer credentials — most contributors only need pnpm dev.

Create a .env file from the provided example and fill in your Apple Developer credentials:

cp .env.example .env
# edit .env with your APPLE_ID, APPLE_ID_PASSWORD, APPLE_TEAM_ID, and certificate details

Then run:

pnpm package

The output will be in the dist/ directory.

Testing

End-to-end tests

The E2E suite covers pane lifecycle smoke tests using Playwright:

pnpm test:e2e

Runs a full vite build first; expect 30–60s per run. See tests/e2e/README.md for details on adding new tests.

Keyboard Shortcuts

All shortcuts are customizable via Settings > Keybindings. Every shortcut also appears next to its item in the menu bar, and Help › Search finds any menu item by name.

Tabs

Shortcut	Action
Cmd+T	New tab
Cmd+Shift+W	Close tab
Cmd+Shift+]	Next tab
Cmd+Shift+[	Previous tab
Cmd+1 – Cmd+9	Switch to tab by number
Cmd+Shift+T	Reopen closed pane

Panes

Shortcut	Action
Cmd+D	Split horizontally
Cmd+Shift+D	Split vertically
Cmd+W	Close pane
Cmd+]	Next pane
Cmd+[	Previous pane

Panels

Shortcut	Action
Cmd+\	Toggle sidebar
Alt+Cmd+\	Split panel right
Shift+Alt+Cmd+\	Split panel down
Alt+Cmd+]	Focus next panel
Alt+Cmd+[	Focus previous panel

App

Shortcut	Action
Cmd+K	Command palette
Cmd+,	Settings
Cmd+N	New agent
Cmd+Shift+N	New workspace
Cmd+Shift+B	New browser window
Shift+Cmd+.	Copy branch name
Ctrl+Cmd+↓	Next workspace
Ctrl+Cmd+↑	Previous workspace

Zoom

Shortcut	Action
Cmd+0	Reset zoom
Cmd+=	Zoom in
Cmd+-	Zoom out

Browser Pane

Shortcut	Action
Cmd+R	Reload page
Cmd+L	Focus URL bar
Escape (double-tap)	Return focus to app

Diff Pane

Shortcut	Action
Cmd+F	Open search
Enter	Next search result
Escape	Close search
Cmd+Enter	Submit commit

Inspirations

• superset
• supacode
• react-grab
• libghostty
• xterm
• t3code
• agent-deck