ASMGR Desktop # 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. [![Release](https://img.shields.io/github/v/release/izll/agent-session-manager-desktop?style=flat)](https://github.com/izll/agent-session-manager-desktop/releases) [![Go](https://img.shields.io/badge/Go-1.24+-00ADD8?style=flat&logo=go)](https://go.dev) [![Wails](https://img.shields.io/badge/Wails-v2-DF0000?style=flat)](https://wails.io) [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) A running Claude session in Agent Session Manager Desktop
--- 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. The project dashboard: grouped sessions with Git status and agent usage A session's changes side by side, with the file tree beside them ## Sessions on a server A session can run on another machine instead of this one. The agent keeps working there after you close the app, reboot your laptop, or walk away — the session lives in the server's `tmux`, and the app is only looking at it. Set one up in **Settings › Remote servers**: add the host, choose how to sign in (ssh-agent, a key file or a password), and press **Test connection**. The test reports what it found step by step — whether it reached the machine, whether it signed in, whether `tmux` is there, and which agents are installed. A server you have not connected to before shows its fingerprint for you to accept; one whose identity has changed is refused outright. If the server has no `tmux`, the test offers to install it. What would run is shown first, and the package manager is asked in advance what it would change: if installing would remove anything, nothing is installed and you are told what it wanted to take off. Once a server is set up, **New session** gains a *Runs on* field. Sessions running elsewhere are marked in the sidebar with the server's name. Requirements on the server: SSH access, `tmux`, and whichever agents you want to run there, signed in as themselves. Agents installed somewhere a non-interactive shell does not look — `~/.local/bin`, nvm — need that directory in the server's **Extra PATH** field, since an SSH command reads no shell profile. A small helper program is installed at `~/.asmgr/asmgrd` on first connection. It is a single static binary with no dependencies, it holds no state, and it ends when you disconnect. Your sessions keep running without it. ## Install Grab the latest build for your platform from the [**Releases**](https://github.com/izll/agent-session-manager-desktop/releases) page. **Linux** ```bash # Debian / Ubuntu sudo dpkg -i asmgr-desktop_*_linux_x86_64.deb # Fedora / RHEL sudo rpm -i asmgr-desktop_*_linux_x86_64.rpm ``` Installs to `/usr/bin/asmgr-desktop` with an app-menu entry; runtime deps (`libwebkit2gtk-4.1-0`/`webkit2gtk4.1`, `tmux`) are pulled in automatically. **macOS** (Apple Silicon, macOS 15 or later) ```bash tar -xzf asmgr-desktop_*_darwin_arm64.tar.gz # → asmgr-desktop.app # move it to /Applications, then: brew install tmux ``` **Windows** (x64) — run `asmgr-desktop_*_windows_amd64_setup.exe`. It installs per-user, so it never asks for administrator rights and in-place updates work. There is also a `.tar.gz` if you would rather not install anything. > ⚠️ **A terminal multiplexer is required at runtime.** Sessions run inside it, > so the app cannot create one without it — it says so on startup and offers the > install command. > > - **Linux** — `tmux`, pulled in automatically by the `.deb` / `.rpm`. > - **macOS** — `brew install tmux`. > - **Windows** — [psmux](https://github.com/psmux/psmux), a native Windows > multiplexer that speaks tmux's command language; no WSL or MSYS2 needed. > The app can install it for you with `winget`, or `winget install psmux`. To build from source instead, see [Build](#build) below. ## Getting started **Your first session.** Press `Ctrl+Shift+N`, pick the agent you want and the directory it should work in, and give it a name. The session starts in its own multiplexer window and appears in the sidebar; press `Enter` to attach and you are looking at a live terminal. Type in it exactly as you would anywhere else. Close the window whenever you like. The agent is not running *inside* the app — it lives in tmux (or psmux) — so it keeps working while the app is shut, and reattaches where it left off next time. **Tabs.** A session can hold several agents and terminals side by side, each its own tab. `Ctrl+T` opens the full dialog — which agent, what arguments, which directory — and `Ctrl+Shift+T` skips all of it and gives you a shell, asking only for a name. Move between tabs with `Ctrl+PageUp` / `Ctrl+PageDown`. **Keeping track of many.** Once you have more than a handful: - Group related sessions into projects with `Ctrl+Shift+G`, and star the ones you return to most (`Ctrl+Shift+8`); starred sessions get their own group at the top and answer to `Ctrl+Shift+1`…`7`. - Build a jump list with `Alt+J` for the tabs you keep coming back to, then `Ctrl+J` and a digit to land on one. - Type `/` to filter the sidebar, or `Ctrl+K` to search everything at once — sessions, projects, tabs and actions. **Getting told when something needs you.** The ⏳ count in the header is every agent currently waiting on an answer; click it to jump to one, or answer *yes / no / Enter / Esc* from the dropdown without leaving the tab you are in. In **Settings → Notifications** you can add a desktop notification, a sound, and an ntfy topic so your phone is pinged too — set the topic URL to something like `https://ntfy.sh/my-topic` and install the ntfy app on your phone. Everything here is off until you turn it on. **Reading what it did.** With a session attached, the view bar switches between the terminal, the session's Git diff, its files, notes and tasks. In the diff you can revert one file or one hunk, step through the changes with `Ctrl+F7`, or jump from a line straight into the editor. `Ctrl+Shift+Y` opens the repository's commit history when you want to look further back than the working tree. ## Keyboard shortcuts Every one of these is editable in **Settings → Shortcuts**, and the ones you never use can be switched off. The in-app help (`Ctrl+Shift+H`) is generated from the same list, so it always shows what your keys actually do — this table is the defaults. | | | |---|---| | `Ctrl+Shift+↑` / `Alt+↑` | Previous session (works in the terminal) | | `Ctrl+Shift+↓` / `Alt+↓` | Next session (works in the terminal) | | `Ctrl+Shift+K` / `Ctrl+Shift+J` | Move the session up / down the sidebar | | `Enter` | Attach to the selected session | | `Ctrl+PageUp` / `Ctrl+PageDown` | Previous / next tab | | `Ctrl+T` | New tab | | `Ctrl+Shift+T` | New terminal tab, name only | | `Ctrl+Shift+N` | New session | | `Ctrl+Shift+G` | New group | | `Ctrl+Shift+S` / `Ctrl+Shift+X` | Start / stop the session | | `Ctrl+Shift+D` | Delete the session | | `Ctrl+Shift+8` | Star the session | | `Ctrl+Shift+1`…`7` | Jump to a starred session | | `Ctrl+J` / `Alt+J` | Quick jump list / add this tab to it | | `Ctrl+K` | Command palette | | `Ctrl+P` | Saved commands | | `Ctrl+Shift+F` | Search every session's history | | `Ctrl+Shift+L` | Search this terminal's scrollback | | `Ctrl+Shift+O` | Find a file by name or content (in the file browser) | | `/` | Filter the session list | | `Ctrl+F7` / `Ctrl+Shift+F7` | Next / previous change in the diff | | `Ctrl+Shift+Y` | Commit history | | `Ctrl` + scroll / `Ctrl+0` | Resize the terminal text / reset it | | `Ctrl+Shift+H` | Help | | `Ctrl+Shift+U` | Check for updates | | `Ctrl+Shift+I` | Import sessions | | `Esc` | Close a dialog | `Esc`, `Enter`, `/`, `Ctrl` + scroll and the starred-session slots stay fixed: their meaning comes from where you are rather than from a binding. `Ctrl+Shift+O` belongs to the file browser itself and is fixed for the same reason. ## Where things live Everything the app keeps is under one directory — `~/.config/agent-session-manager-desktop` on Linux, the equivalent per-user config directory on macOS and Windows: | | | |---|---| | `sessions.json` | your sessions, groups, settings and recycle bin | | `commands.json` | the saved command library | | `backups/` | automatic snapshots of the above, and of task files | | `activity-stats.json` | locally-observed agent activity | | `asmgr-desktop.log` | the run log, also readable from Settings | Tasks are the exception: they live with the code, in `.taskmaster/tasks.json` inside each working directory, because that is where Task Master keeps them and the two have to agree. **What leaves your machine.** Nothing, unless you ask for it. The app talks to GitHub to check for its own updates, to an ntfy server if you configure mobile push, and to `npx` the first time you use a Task Master AI action. Your sessions, their output and your files stay local — there is no telemetry. ## Questions **Can I close the app while an agent is working?** Yes — that is the point. The agents run in tmux/psmux, not in the app, so closing the window leaves them working. Reopen and reattach. **What happens if the app crashes?** The same thing: the sessions are untouched. Start it again and they are all there. **I deleted a session by accident.** Open the recovery centre (the recycle bin icon). Deleted sessions and tabs sit in it for as long as you choose, and your settings are snapshotted as they change — densely for the last hour, then thinning out over months — so a mistake noticed tomorrow is still undoable. **An agent is running but shows as idle.** Activity is read from what the pane prints, so an unusual prompt can fool it. Settings has an update button for the detection patterns, which is quicker than waiting for a release of the app. **The terminal feels sluggish.** Try a different renderer in **Settings → Terminal** — canvas is the default, but DOM and WebGL are there and switch live. **Can I use it over SSH or on a headless box?** Not this one — it is a desktop app. The [TUI version](https://github.com/izll/agent-session-manager) runs in a terminal and does the same job; it keeps its own session list, but both drive tmux, so the agents themselves are reachable either way. **Does it work with an agent that isn't in the list?** Yes. Choose *Custom* and give it the command to run; it gets a tab and a status line like the rest. ## Requirements - Go 1.24+ - Node.js + npm - `tmux` (Linux, macOS) or [psmux](https://github.com/psmux/psmux) (Windows) - Linux: WebKitGTK. On Ubuntu 24.04+ / Fedora 40+ only `webkit2gtk-4.1` is available — build with the `webkit2_41` tag (see below). - [Wails CLI](https://wails.io/docs/gettingstarted/installation) ## Build ```bash # Linux with webkit2gtk-4.1 (Ubuntu 24.04+, Fedora 40+): wails build -tags webkit2_41 # Other / older WebKitGTK: wails build ``` The binary is written to `build/bin/`. ### Development ```bash wails dev -tags webkit2_41 ``` `wails dev` also serves the frontend at , so you can open it in a regular browser (with Go methods bridged) for fast iteration. ## How it works - Each session is a multiplexer session — `tmux` on Linux and macOS, `psmux` on Windows — so agents keep working when the window is closed and reattach instantly. - The terminal talks to the agents over a local, token-authenticated WebSocket (xterm.js ⇄ Go ⇄ multiplexer), which keeps typing latency low. - Output from a tab you are not looking at is held in the backend and replayed when you return to it, rather than being dropped and repainted. One WebKit main thread serves every tab, so a busy background agent must not be able to starve the one you are typing in. - Session storage lives under `~/.config/agent-session-manager-desktop/`. ## License MIT — see [LICENSE](LICENSE).