convez.ai
PluginProdutividadeIntermediário
r4nd3l

Claude Session Manager

r4nd3l/claude-session-manager

Gerencie sessões Claude Code com interface desktop GTK4 nativa

Ver no GitHub
InicialPluginScore · de 0 a 100

Aplicativo desktop nativo GTK4 para gerenciar e retomar sessões do Claude Code. Oferece interface visual com abas, busca, favoritos e gerenciamento em massa de sessões, mantendo todo o estado em arquivo de configuração separado.

Instalação

$npx convez-ai r4nd3l/claude-session-manager

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
5
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 2 semanas
Versão
v1.1.1
Issues abertas
2
Contribuidores
1

Casos de uso

  • Organizar e retomar múltiplas sessões de codificação Claude
  • Pesquisar e filtrar sessões por nome, projeto ou ID
  • Executar sessões em abas com terminal embutido
  • Marcar sessões favoritas e gerenciar em massa

Veredito

Ferramenta comunitária bem-estruturada que adiciona camada produtiva ao Claude Code com interface polida. Requer Linux/GTK4 e é ideal para desenvolvedores que lidam com múltiplas sessões simultaneamente.

README

A tradução para o português deste README ainda está na fila.

Claude Session Manager

CI

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.
  • 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.
  • Preferences (menu → Preferences, or Ctrl+,): terminal font, scrollback, color scheme.
  • A status footer shows session, project, transcript-size, and open-tab counts.

Keyboard shortcuts

ShortcutAction
Ctrl+Shift+FFocus search
Ctrl+Shift+TNew session
Ctrl+Shift+WClose current tab
Ctrl+PgUp / Ctrl+PgDnPrevious / next tab
Ctrl+Shift+C / Ctrl+Shift+VCopy / paste in terminal
Ctrl+Shift+GFind in terminal
F9Toggle 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.

Install

Debian/Ubuntu — .deb package (from the latest release):

sudo apt install ./claude-session-manager_0.5.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/
├── eu.zengo.ClaudeSessionManager.desktop   # launcher template
├── icons/eu.zengo.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

Roadmap

  • Transcript peek: render last messages in the details dialog
  • Drag-and-drop sessions into Favorites
Ver o original no GitHub

Bom para

Relacionados