Overseer is a desktop app (Linux, macOS, Windows), a phone and tablet app (Android, iOS) and a small
daemon. It works with Claude Code, Codex, Gemini CLI, Antigravity, opencode, Amp, Copilot CLI, Cursor
Agent and Mistral Vibe. Each agent session is a line: one agent, in one worktree, on one machine, for
one owner. The daemon owns the terminals, so closing the app, losing Wi-Fi or putting the laptop
to sleep stops nothing; open the app again and every session is where you left it.
New here? Install the app, open it, and take the tour: it shows each part of the window in about
a minute. You can replay it any time from Settings → Help.
Features
Every agent in one window
Workspaces group sessions by project. Inside a workspace, subjects sort its sessions further: a
subject covers a sub-folder or a git submodule (submodules show up on their own), sessions running
there join it, and you can drag any session onto one or start a new one in it, at the workspace
root if your agents read their instructions there. Each session opens in a tab with its live terminal, and
the side panel shows what the agent is doing: last message, work log, todos, edited files and
changes. Switch to By status to see at a glance who needs your input, who is running and who
is done. Agent tabs also have a Chat view rebuilt live from the agent's session file.
Terminals can optionally be drawn on the GPU with WebGL (Settings, Terminal, GPU rendering,
off by default and experimental), which keeps long output smooth. Clicking in the line you are
typing, in a shell or an agent like Claude Code or Codex, moves the cursor there like in a text editor.
An agent you have not installed yet is one click away: pick it under + and its install
command runs in a new terminal, then it is ready to start.
Coming from Switchboard, the old name of Overseer? When its data is found, Overseer offers to import
your sessions, tasks, workspaces and settings in one click (also in Settings, Help).
A task board that starts agents for you
Write a task, pick the agent, its model and reasoning effort, and start it: Overseer creates a
worktree on a new branch and types the task into the agent. Tasks in the Auto column start on
their own, in order, within your concurrency limit. A new task can be filled from the project's
GitHub or GitLab issues or Jira tickets, and agents can read and update tasks through the
built-in MCP server. Finished work waits in Review; a task moves to Merged by itself once
its branch lands in the default branch, Closed keeps the rest, and an agent moves its task
back to In progress when work resumes. Tick Quorum on a Claude or Codex task and its agent
splits the work between several agent CLIs; one or two other agents review each result and vote
with the orchestrator, and only results a majority accepts are merged.
Live review of what agents change
A GitHub-style review of an agent's changes while it works. Comment on lines, suggest edits, and
send the comments back to the agent; threads follow the code as it changes. Approve, reject or
commit from the Kanban card when the task is in Review. When an agent works across several
repositories, one review covers them all: the Map view draws every worktree on one map with the
links between files, colours each file by what makes it worth your attention (real logic, blast
radius, contract changes, where the agent struggled, untested or not yet seen code), and J and K
walk the files hottest first.
Source control, Git graph and worktrees
The git button above each session opens its live review: the agent stays on the left, the
review of everything it changed sits beside it, the sidebar shrinks to a rail of sessions, and one
bar at the bottom runs git on the worktree you pick among the session's worktrees and submodules.
Write a message and press Enter to commit; Push, Publish or Pull takes the button's place when it
is the next step, and the ⋯ menu holds fetch, amend, stage or discard all, merge, stash and the Git
graph. While you work in a terminal, the sidebar's Git tab (Ctrl+Shift+G) keeps source control at
hand like VS Code: the selected session's worktree, its branch, fetch, pull and push, a commit box,
staged and changed files, and merge and stash. The Git graph tab keeps a per-project history that stays fast on large histories, with agent
branches, tasks and PRs on it; from a commit you can merge it into a worktree or revert it.
Worktrees live in one store outside your repositories, show whether they are in use, idle
or stale, and are cleaned up safely: Clean up merged picks the merged ones with no agent left,
and you untick the ones to keep.
Remote machines over SSH
Point the app at any host that works with ssh <host>: your ~/.ssh/config, ProxyJump,
ProxyCommand, agents and keys are used as is. The app installs the daemon on first connection
and carries terminals, events and forwarded ports over a single SSH connection. Nothing listens
on a TCP port on the server.
Keep each host in its own window, or put this computer and several SSH hosts in one window:
each host gets a live section in the sidebar, and a click on one of its sessions brings it into
the main area. One window per host stays the default; pick the other in Settings or when you
connect.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
