Overseer plugin
Tern terminal plugin: one panel for every branch with worktrees, agents, PRs and tickets, plus a Visualize PR skill.
- 107 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The plugin creates and deletes worktrees and branches through Worktrunk and reads GitHub and Linear state.
Install
- Works in
Manual install
tern plugin install github.com/mmnavarr/overseerRequires macOS, Tern 0.9.15 or newer and Worktrunk.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The plugin creates and deletes worktrees and branches through Worktrunk and reads GitHub and Linear state.
This is third-party code. Review the repository files before installing.
What it does
Overseer is a plugin for the Tern terminal that keeps every branch in flight in one panel: worktree, agents, pull request and ticket. Each branch gets its own Tern session with its own tabs and agents, and switching takes one click. A row shows whether an agent is working, waiting for you, finished or failed, plus GitHub PR state and the Linear ticket. When an agent splits a task into one branch per fix, the sub-worktrees nest under the task and their agents keep each other informed. Worktree creation and deletion run in the background through Worktrunk, hooks included. The Visualize PR skill turns a pull request into a diagram-first outline for review. Claude Code, Codex, Gemini and Aider get the panel and status, while the omp agent unlocks the rest.
Who it is for. People running several branches with agents in parallel who lose track of which one is stuck waiting for an answer.
Good fit when
- Five agents work in five branches and you need one screen with each one's status.
- Every branch has a PR and a ticket and their state should show in the row.
- An agent splits a task into sub-branches that should nest under the parent.
- A pull request should be reviewed as a diagram before reading the diff.
Not a fit when
- You do not use Tern; the plugin does not install outside it.
- You have no macOS; that is the supported platform.
- There is only one branch and no panel is needed.
Example request
Show the status of all branches in Overseer and turn the current branch's «pull request» into a diagram for review.Limitations
macOS, Tern 0.9.15 or newer and Worktrunk (`brew install worktrunk`, tested with 0.40 and 0.81) are required. Optional additions: GitHub CLI `gh`, signed in, for PR badges and Visualize PR, and Linear CLI `linear`, signed in, for tickets. Starting agents from a ticket, Visualize PR and sub-worktrees created by agents are available only in omp. Family news before each prompt and agent-to-agent messaging are also omp only. Other agents get the panel, status and Overseer's messages. The plugin manages worktrees and branches, so deleting a worktree through it is irreversible for unsaved work.
How to disable. Remove the plugin with Tern's plugin removal command and delete the worktrees it created with Worktrunk commands.
FAQ
How do I install Overseer?
Run `tern plugin install github.com/mmnavarr/overseer` in any terminal. Tern downloads it into its own plugins folder, with no clone or build.
Which agents are supported?
Any agent CLI: Claude Code, Codex, Gemini and Aider get the panel and status. The `omp` agent unlocks tickets, Visualize PR and sub-worktrees.
What must I install first?
Tern 0.9.15 or newer and Worktrunk. PR badges and Visualize PR need `gh`, tickets need `linear`, both signed in.
How do I open the projects panel?
Press ⌘⌥⇧P. A list of branches opens, with agent, PR and ticket status on every row.
What does Visualize PR do?
Turns a «pull request» into a diagram-first outline that makes a good start for review. The skill needs `gh`, signed in.
Discussion
No questions or reviews yet.
Related
PluginsA Rust terminal with a multiplexer: agent sessions from several machines in one window, plus a skill for seeing adjacent panes
A tmux console you can open from a phone: agents in separate worktrees show up in a sidebar and wait for your answers.
A plugin that teaches Claude Code and Codex to drive the agterm macOS terminal via agtermctl: sessions, panes, overlays, status
A Rust CLI and TUI: agents in containers, parallel tabs, TOML workflows from issue to PR and a scheduled agent squad
A git worktree CLI built for running Claude Code and Codex in parallel: the wt command, a plugin, and automation hooks
A native macOS terminal built on Ghostty with vertical tabs and notifications when an agent needs your input
README in short
A Tern plugin that unites branches, worktrees, agents, PRs and tickets in one panel and adds a skill for «pull request» review.