Skip to main content
Change of provenance

The repository or configuration that created this release differ from a previous release. View details.

Claude Session Manager

CI PyPI AUR Release

Native GTK4/libadwaita desktop app to manage Claude Code sessions.

📖 Documentation

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.

Claude Session Manager

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 $SHELL with claude --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 claude there.
  • 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 use pipx 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)

Source distribution for claude-session-manager-gtk 0.8.0
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)

Table of built distributions (wheels) for claude-session-manager-gtk 0.8.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.8.0 This release

2 release files Change of provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page