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.0.24 · 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
One-line installer
curl -fsSL https://tui.xed.dev/install.sh | bash
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.0.24
- 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-sessionmemory/<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 appCtrl+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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xed_tui-1.0.24.tar.gz.
File metadata
- Download URL: xed_tui-1.0.24.tar.gz
- Upload date:
- Size: 46.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f7b5460eb780a00bb0d6f5ee1a3989bb26ac5d7bb5fd4556711257ab2ca18fed
|
|
| MD5 |
f5b34bbf257c3ce32be66db8fa876ec8
|
|
| BLAKE2b-256 |
20572aac41029a9fb1e7306b5f43d2c9ac11e9883cb0f0765873a5bb475b1565
|
Provenance
The following attestation bundles were made for xed_tui-1.0.24.tar.gz:
Publisher:
publish-pypi.yml on XED-dev/TUI
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
xed_tui-1.0.24.tar.gz -
Subject digest:
f7b5460eb780a00bb0d6f5ee1a3989bb26ac5d7bb5fd4556711257ab2ca18fed - Sigstore transparency entry: 1068530623
- Sigstore integration time:
-
Permalink:
XED-dev/TUI@6babdabda364c3f6726c05a405779e6dfdb09810 -
Branch / Tag:
refs/tags/v1.0.24 - Owner: https://github.com/XED-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@6babdabda364c3f6726c05a405779e6dfdb09810 -
Trigger Event:
push
-
Statement type:
File details
Details for the file xed_tui-1.0.24-py3-none-any.whl.
File metadata
- Download URL: xed_tui-1.0.24-py3-none-any.whl
- Upload date:
- Size: 29.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e0c42ed3e50d72d9a59c2318d7ba6561a02bf0d92d721a914532ccc877f7c88
|
|
| MD5 |
5ba81708e2fa1b5fd43d69637c1aa919
|
|
| BLAKE2b-256 |
f756150073f5da0fa4937a32708a3add2343aa009a4bf2ea57217e46deb75622
|
Provenance
The following attestation bundles were made for xed_tui-1.0.24-py3-none-any.whl:
Publisher:
publish-pypi.yml on XED-dev/TUI
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
xed_tui-1.0.24-py3-none-any.whl -
Subject digest:
2e0c42ed3e50d72d9a59c2318d7ba6561a02bf0d92d721a914532ccc877f7c88 - Sigstore transparency entry: 1068530682
- Sigstore integration time:
-
Permalink:
XED-dev/TUI@6babdabda364c3f6726c05a405779e6dfdb09810 -
Branch / Tag:
refs/tags/v1.0.24 - Owner: https://github.com/XED-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@6babdabda364c3f6726c05a405779e6dfdb09810 -
Trigger Event:
push
-
Statement type: