
# Agent Session Manager — Desktop
**Run a whole team of AI coding agents from one window.**
Claude, Codex, Gemini, Aider and more — each in its own live terminal, all
side by side, all persistent.
[](https://github.com/izll/agent-session-manager-desktop/releases)
[](https://go.dev)
[](https://wails.io)
[](LICENSE)
---
You've probably got three terminal windows open, each with a different agent
grinding away, and you keep alt-tabbing to check which one is stuck waiting on
you. **Agent Session Manager Desktop** puts them all in one place: every agent
gets its own tab, keeps running in the background, and tells you the moment it
needs your attention — even on your phone.
It's the graphical counterpart of the
[**ASMGR TUI**](https://github.com/izll/agent-session-manager), built with
[Wails](https://wails.io) (Go) + Svelte + [xterm.js](https://xtermjs.org).
Because every session lives in its own multiplexer session — `tmux` on Linux
and macOS, `psmux` on Windows — your agents survive closing the window,
restarting the app, even a machine hop: reattach and pick up exactly where you
left off.
> Prefer the terminal? The original TUI version lives at
> [izll/agent-session-manager](https://github.com/izll/agent-session-manager).
## Why you'll want it
- **Never miss a waiting agent again.** When an agent stops to ask you
something, the header shows a ⏳ count you can click to jump straight to it —
or answer *yes / no / Enter / Esc* right from the dropdown without switching
tabs. Turn on desktop notifications and **ntfy mobile push** to get pinged
wherever you are.
- **Everything keeps running.** Close the window, reboot the app, come back
tomorrow — the sessions are still there and still working, because they live
in the multiplexer rather than in the app. Reattach in one click.
- **See the whole picture.** The project dashboard lays out every session
grouped like your sidebar, with live activity, per-repo Git status (branch,
dirty state, ahead/behind, last commit) and your **Claude and Codex/GPT
usage** — how much of your rate-limit window is left — at a glance.
- **Reach for the right agent instantly.** Search every session, group them
into projects, star your favorites, build a numbered jump list of the tabs
you keep returning to (`Ctrl+J`), and search *inside* a terminal's scrollback
with `Ctrl+Shift+L`. Forgotten which session that conversation happened in?
`Ctrl+Shift+F` searches every agent's history at once.
- **Read what it wrote, without leaving.** Browse and edit the project's files
with syntax highlighting, search them by name or content, and review the
session's diff file by file — reverting a single hunk if you disagree with
it.
## Features
**Agents & sessions**
- **Many agents, your choice** — Claude, Gemini, Aider, Codex, Amazon Q,
OpenCode, a custom command, or a plain shell.
- **Multi-tab sessions** — several agents or terminals per session, each its own
multiplexer window, with a per-tab working directory if you want one
somewhere else.
- **Resume & fork** — continue a previous conversation, or fork a Claude thread
into a new tab or a brand-new session to explore a different path.
- **Background agents** — a dedicated panel lists Claude's `--bg` / Ctrl+B
background agents; attach one into a tab or a new session, tail its logs, or
stop it. Accidentally sent a session to the background? It reattaches cleanly
on the next resume.
- **Session templates** — save an arrangement you keep rebuilding (an agent,
its arguments, and the tabs beside it) and create it again in one step. Pin a
template to a directory or leave it reusable and pick the directory when you
use it.
- **Saved commands** — a searchable library on `Ctrl+P`, organised into groups.
Commands can take parameters — `{{name}}`, or `{{name:default}}` — and you
are prompted for them before the command runs.
- **Command palette** — `Ctrl+K` finds anything by typing: a session, a project,
a tab, or an action such as opening the diff, restarting a tab or jumping to
the next agent that is waiting on you.
- **Quick jump list** — `Ctrl+J` opens your own numbered shortlist of the places
you keep going back to; `1`–`9` jumps straight there. Add the current tab with
`Alt+J`, rename entries, and point one at a whole session or at one exact tab.
- **New tabs from the keyboard** — `Ctrl+T` for the full dialog, `Ctrl+Shift+T`
when you just want a terminal: it asks only what to call it, with the name
filled in and selected.
**Staying in control**
- **Attention inbox** — the ⏳ dropdown of every tab waiting on input, with
one-click replies, no tab switching.
- **Desktop + mobile notifications** — get told the instant an agent starts
waiting, via the platform's system notification and/or an ntfy topic on your
phone. Fully opt-in.
- **Live status everywhere** — busy / waiting / idle dots and status lines in
the sidebar and on the tab headers, read straight from the panes; hide a
chatty tab's status line per-tab when you don't want the noise.
- **YOLO indicator** — shows when an agent is running unattended (Claude's
*bypass permissions* / *auto mode*), read live so it tracks a Shift+Tab
toggle.
- **Fresher activity detection** — the patterns that decide when an agent is
working and when it is waiting can be updated on their own, without waiting
for a release of the app.
**Seeing your work**
- **Project dashboard** — the bird's-eye view: grouped session cards, Git
status per repo, and Claude / Codex usage windows.
- **Activity statistics** — locally-observed agent activity over the last 7, 30
or 90 days: a daily timeline, a breakdown per agent, and which sessions took
the most work.
- **Diff & notes** — review a session's Git changes file by file, grouped into
a directory tree, and revert a single file or a single hunk. Read it inline or
side by side, with a draggable split, `Ctrl+F7`/`Ctrl+Shift+F7` to step through
the changes, and a jump from any line to that spot in the editor. Huge diffs are
guarded so they never freeze the UI. Keep per-tab notes, with search (`Ctrl+F`)
and full undo, split into titled pages (`Ctrl+PgUp`/`Ctrl+PgDn` switch pages in a note of several, tabs elsewhere).
- **Commit history** — `Ctrl+Shift+Y` browses the repository's commits and
branches: the files each one touched, its diff, and a search through the
messages. Read a change on its own or in the whole file, with `F7` stepping
from one to the next. The window resizes from its corner, and its panes fold
away when you want more room.
- **Split view** — pin a tab beside the one you are on and watch two agents work
at once, or compare a session with itself. Swap the two sides or repoint the
pinned one without losing your place.
- **Global history search** — `Ctrl+Shift+F` searches across every session's
conversation history — Claude, Aider, OpenCode and plain terminal scrollback —
ranked, with a preview of the exchange it found.
- **File browser & editor** — read and edit the files your agent is working on
without leaving the app. Syntax highlighting for a dozen languages while both
reading and editing (CodeMirror 6, with grammars loaded on demand), file
search by name or content with `Ctrl+Shift+O`, and colour-coded file types.
Saving preserves a file's line endings, BOM and trailing newline exactly, so
opening and saving an untouched file leaves it byte-identical.
- **Current branch** — the working directory's Git branch beside the session
name or in the status bar, following the pane as you `cd` around, with a
read-only list of the repo's other branches.
- **Tasks with deadlines** — a real task list per working directory: priorities,
due dates that mark themselves overdue, subtasks, dependencies ("what is this
waiting on"), and a filter across the lot. Send a task to the agent to work on,
or tie it to a session so deleting that session warns you about the unfinished
work first. A count of what is still open sits on the tab.
- **Every project's tasks in one place** — one table of every task across every
project, sorted by deadline, filtered to just the overdue or the unfinished.
- **Task Master (optional)** — the task list works on its own; turning this on
adds the AI-backed actions — parsing a PRD, expanding a task into subtasks,
scoring complexity — via the `task-master-ai` MCP package.
**Comfort & polish**
- **Voice dictation** — talk to your agent instead of typing (free or API
speech-to-text modes).
- **Make it yours** — eight interface accents or any colour you like; per-agent
and per-tab terminal palettes, including ones you define; adjustable terminal
font size globally, per tab, or with `Ctrl` + scroll; colour a session or a
group, and hide the view or status bar on tabs that don't need them. Choose
what a plain terminal tab runs, and whether selecting text copies it straight
away or only with Shift held.
- **Bring your own colour scheme** — import the themes already installed for
Konsole, kitty, Alacritty, WezTerm or Ghostty, browse the several hundred in
the iTerm2-Color-Schemes collection, or open a scheme file from anywhere. Each
one previews before you keep it.
- **Rebindable shortcuts** — every keyboard shortcut is editable in Settings,
and the help dialog is generated from the same list, so it always shows what
the keys actually do. Shortcuts you don't use can be switched off. A handful
stay fixed because their meaning comes from where you are — `Esc`, `Enter`,
`/`, `Ctrl` + scroll to zoom, and `Ctrl+Shift+1`…`7` for the favourite slots.
Keys named throughout this README are the defaults.
- **Selectable terminal renderer** — canvas (default), WebGL, or DOM,
switchable live from Settings.
- **Recovery centre** — deleted sessions and tabs go to a recycle bin you can
restore from, kept for a period you choose. Beside it, your settings and
session list are snapshotted automatically as they change — everything from
the last hour, then thinning to one an hour, one a day and one a week going
back months — so a mistake noticed tomorrow is still undoable. Task files are
backed up separately, and you can take a snapshot by hand at any time.
- **Picks up where you left off** — the tab you were on and your place in a file
come back when you return to a session.
- **20 languages** — the whole UI is translated.
- **Safe alongside itself** — open a second window and it won't stomp on the
first one's terminals; it warns you and stays read-only for that project.
- **Self-updating** — checks for new releases in the background and updates in
place on all three platforms, including `.deb` / `.rpm` installs and the
macOS `.app` bundle. The Windows installer is per-user, so updating never
needs administrator rights.
- **Take it with you** — export sessions to a file and import them on another
machine.
- **Nothing to install first** — if `tmux` (or `psmux` on Windows) is missing,
the app offers to install it for you.
- **See what it's doing** — the application log is readable from Settings,
filterable and copyable, for when something needs explaining.