Skip to main content

Terminal browser and session manager for Claude Code — zero dependencies

Project description

XED /TUI

A mutt-style session browser for Claude Code — terminal-first, zero dependencies, no cloud. Deutsche Version: de/README.md

Version: v1.022 · License: MIT · Org: Collective Context (CC)


What is XED /TUI?

XED /TUI is a terminal browser for Claude Code sessions — inspired by mutt (email) and ranger (file browser). It runs entirely locally, requires no API and no cloud service.

Who needs it: Anyone using Claude Code daily who wants to browse, annotate, resume, and manage their sessions directly in the terminal.


Installation

Recommended — uv (fastest)

uv tool install xed-tui

pip / pipx

pipx install xed-tui
# or:
pip install xed-tui

npm

npm install -g @xed-dev/tui

From source

git clone https://github.com/XED-dev/TUI.git
cd TUI
python -m xed_tui

Requirements: Python 3.11+ · Unix terminal (Linux, macOS, WSL) · no pip packages needed


Features — v1.022

  • 4-Panel Layout — Projects · Sessions · Reader · Notes (side-by-side)
  • Session Browser — all ~/.claude/projects/ sorted by recency
  • Reader — full transcript with Markdown rendering (**bold**, `code`, tables, code blocks)
  • [a] Resume — start Claude Code with --resume <uuid> (CWD automatic)
  • [r] Clipboard/resume <uuid> → clipboard (for a running Claude Code)
  • [e] Notes — per-session memory/<uuid>.md, editable in any editor
  • [t] Title — rename sessions (syncs with Claude Code + ZED History)
  • [/] Search — live search across titles and notes
  • [#] Tags — label sessions, filter by tag (/#hvd)
  • Ctrl+E — Settings: configure editor and default app
  • Ctrl+R — hot-reload, state preserved via --continue
  • Multi-language help — DE / EN / FR / JA / ES (? key)

Quickstart

xed-tui                  # start
xed-tui --continue       # restore last state
xed-tui --help           # full keybinding reference

→ Full guide: docs/quickstart.md


Keybindings

Key Action
↑↓ / j k Navigate
Tab / ← → Switch panel
Enter Open session
a Start Claude Code --resume
r Resume command to clipboard
e Open note in editor
o Open note in default app
t Set title
/ Live search
# Set tags
f Reader fullscreen
n Notes fullscreen
Ctrl+E Settings (editor, app)
Ctrl+R Hot-reload
? Help (5 languages)
q Quit

→ Full reference: docs/keybindings.md


Why XED /TUI?

ZED and Claude Code have no built-in tool to read, annotate, search and resume sessions. Sessions are stored as .jsonl files locally — human-readable, no lock-in. XED /TUI is the browser for them.


Contribute

All languages welcome · Alle Sprachen willkommen.

CONTRIBUTING.md · Issues · Discussions


Building XED /TUI @ Collective Context (CC) · License: MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xed_tui-1.22.tar.gz (43.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xed_tui-1.22-py3-none-any.whl (29.2 kB view details)

Uploaded Python 3

File details

Details for the file xed_tui-1.22.tar.gz.

File metadata

  • Download URL: xed_tui-1.22.tar.gz
  • Upload date:
  • Size: 43.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for xed_tui-1.22.tar.gz
Algorithm Hash digest
SHA256 7d9ca9d8510d7baf6536843753ad3448f23821a4fd9e813c7dfdf4e34cf4fd8c
MD5 1cdf5522c9932feb7f0420043e5fb057
BLAKE2b-256 118122e08a75eeff7f78c5bd89acaf6f26a2d63aa6ede6235647cf8ff2010b8b

See more details on using hashes here.

File details

Details for the file xed_tui-1.22-py3-none-any.whl.

File metadata

  • Download URL: xed_tui-1.22-py3-none-any.whl
  • Upload date:
  • Size: 29.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for xed_tui-1.22-py3-none-any.whl
Algorithm Hash digest
SHA256 d8407b8bc2af7eda9fc15548fb45de216f1c4c5a6f5f27825c375ad7e1a2af16
MD5 e52102775be3abce57b875abf842dabc
BLAKE2b-256 f5616f15c8d7fb2687cb858d7591845c1d2a3cbebbd5edcbf4156ab3cf958eb2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page