The repository or configuration that created this release differ from a previous release. View details.
Claude Session Manager
Native GTK4/libadwaita desktop app to manage Claude Code sessions.
Unofficial community tool. Not affiliated with or endorsed by Anthropic. It never modifies Claude Code's own data — all app state lives in its own config file.
Features:
- Sidebar lists every session found under
~/.claude/projects/, grouped by project (collapsible headers, with collapse-all/expand-all buttons next to the search box), with a Favorites section pinned on top — star a session to move it there. A search box filters by name, project, preview, or session id, and the list updates live as sessions are created or written to. - Sessions can be given custom names (pencil icon). Names, favorites, and hidden sessions persist in
~/.config/claude-session-manager/state.json— Claude's own session files are never modified. - Clicking a session opens a tab in the main area; each tab is an embedded VTE terminal running your
$SHELLwithclaude --resume <session-id>typed into it, in the session's original project directory. When claude exits you drop to a shell prompt; the tab closes when the shell exits. Closing a tab asks Claude to exit cleanly (/exit) in the background first. - In-terminal search with a find bar (
Ctrl+Shift+G) over the tab's scrollback. - Status dots in both the sidebar and on each open tab: green = open, blue = output arrived in a background tab. A waiting badge (amber ?) marks sessions where Claude's last message was a question awaiting your reply.
- Tabs can be renamed, given an emoji prefix, or have their session ID copied (right-click → Rename… / Set emoji… / Copy session ID); renaming a session's tab updates its name everywhere. A close-all button appears when more than one tab is open, and the sidebar toggles with the header button or
F9. Shift+Enter inserts a newline in Claude's prompt. - Right-click a session for the full action set: open, open in Ghostty (external window — Ghostty can't be embedded), fork (
--fork-session), rename, favorite, details (messages/models/tokens, a peek at recent messages, and MCP servers/usage), copy session id, reveal transcript, hide, or move the transcript to trash. - Desktop notifications when a background session goes quiet after producing output — click to jump to that tab (toggle in Preferences).
- Select mode (checkbox button in the sidebar header) for bulk actions: open, star, hide, or trash many sessions at once.
- New session (tab icon in the header) asks for a project folder and starts a fresh
claudethere. - Quick switcher (
Ctrl+Shift+K) jumps to any session by type-ahead; the New Session button remembers your last folder; the sidebar is resizable and its width is remembered. - MCP servers browser (menu → MCP servers): a read-only view of every MCP server configured in
~/.claude.json, global and per-project. - Preferences (menu → Preferences, or
Ctrl+,): terminal font, scrollback, color scheme. - A status footer shows session, project, transcript-size, and open-tab counts.
Keyboard shortcuts
| Shortcut | Action |
|---|---|
Ctrl+Shift+F |
Focus search |
Ctrl+Shift+T |
New session |
Ctrl+Shift+N |
New window |
Ctrl+Shift+W |
Close current tab |
Ctrl+PgUp / Ctrl+PgDn |
Previous / next tab |
Ctrl+Shift+C / Ctrl+Shift+V |
Copy / paste in terminal |
Ctrl+Shift+G |
Find in terminal |
Ctrl+Shift+K |
Quick switcher (jump to any session) |
F9 |
Toggle sidebar |
Ctrl+, |
Preferences |
Requirements
Python ≥ 3.10, GTK 4, libadwaita ≥ 1.5, VTE (GTK 4 build), PyGObject — from your distro's packages:
# Ubuntu / Debian
sudo apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1 gir1.2-vte-3.91
# Fedora
sudo dnf install python3-gobject gtk4 libadwaita vte291-gtk4
# Arch
sudo pacman -S python-gobject gtk4 libadwaita vte4
Plus the claude CLI on your PATH.
Installing with
pipx? PyGObject comes from the system, so usepipx install --system-site-packages claude-session-manager-gtk.
Install
Ubuntu — PPA:
sudo add-apt-repository ppa:matemiller992/claude-session-manager
sudo apt update && sudo apt install claude-session-manager
Arch — AUR: yay -S claude-session-manager
Any distro — pipx: pipx install --system-site-packages claude-session-manager-gtk
Debian/Ubuntu — .deb package (from the latest release):
sudo apt install ./claude-session-manager_0.8.0_all.deb
Dependencies are pulled in automatically; the app appears in your app grid as "Claude Session Manager".
From source:
cd ClaudeSessionManager
python3 -m claude_session_manager
Or install the desktop launcher + icon (shows up in the app grid as "Claude Session Manager"):
./data/install.sh
Terminal shortcuts: Ctrl+Shift+C copy, Ctrl+Shift+V paste.
Layout
claude_session_manager/
├── app.py # Adw.Application entry point + CSS
├── window.py # main window: split view, sidebar, tabs, actions, dialogs
├── sessions.py # session discovery + transcript statistics
├── state.py # persistent app state (names, favorites, hidden, settings)
├── prefs.py # preferences dialog
└── terminal.py # VTE terminal tab spawning the claude CLI
data/
├── io.github.r4nd3l.ClaudeSessionManager.desktop # launcher template
├── icons/io.github.r4nd3l.ClaudeSessionManager.svg # app icon
└── install.sh # install launcher + icon for current user
scripts/
├── build_deb.sh # build the .deb package into dist/
└── make_demo_data.py # fake sessions for screenshots/demos
Publishing (maintainers)
Releases are one step: push a v* tag. .github/workflows/release.yml then
builds the wheel/sdist and the .deb, creates the GitHub Release (with the
.deb attached and auto-generated notes), and publishes to
PyPI via trusted
publishing (OIDC — no API tokens).
# bump version in pyproject.toml / __init__.py / debian/changelog, commit, then:
git tag -a v0.8.0 -m v0.8.0 && git push origin v0.8.0
PyPI trusted-publisher setup expects workflow release.yml (owner r4nd3l,
repo claude-session-manager). The AUR and PPA are updated separately
(see packaging/).
Roadmap
- Distribution: AUR, Ubuntu PPA, Flathub
- Optional: terminal color themes, "watch a project", i18n
Metadata
Release files for claude-session-manager-gtk 0.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Change of provenance
The repository or configuration that created these release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| claude_session_manager_gtk-0.8.0.tar.gz | 63.8 kB | With provenance | Details for claude_session_manager_gtk-0.8.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| claude_session_manager_gtk-0.8.0-py3-none-any.whl | Python 3 | none | any | Details for claude_session_manager_gtk-0.8.0-py3-none-any.whl |
Total release size: 134.6 kB
Release files / claude_session_manager_gtk-0.8.0.tar.gz
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | claude_session_manager_gtk-0.8.0.tar.gz |
|---|---|
| Size | 63.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
198d8de677f34c43911dbaad68742486b0e0938eb60bf852f4d314a809a1528b
|
|
BLAKE2b-256 checksum How to use checksums |
49d92ab2485a45ffcdbb07ac2792bac2e953cd5ecaf91781c82c44d6750e1b06
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 11, 2026.
Transparency logRelease files / claude_session_manager_gtk-0.8.0-py3-none-any.whl
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | claude_session_manager_gtk-0.8.0-py3-none-any.whl |
|---|---|
| Size | 70.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5c0b7d237213e734dd64cc591a71f9a5d76e6b9a1dc2006a6799358b7f81b176
|
|
BLAKE2b-256 checksum How to use checksums |
55daf41604ee59e688e8d928ccff14a4b792928ca8c8d0e5e55de64306d50fbc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 11, 2026.
Transparency logSecurity for claude-session-manager-gtk 0.8.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Change of provenance
The configuration that created this release differs from a previous release.
While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.
Attestation for claude_session_manager_gtk-0.8.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 11, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.