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.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-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.0.24.tar.gz (46.4 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.0.24-py3-none-any.whl (29.4 kB view details)

Uploaded Python 3

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

Hashes for xed_tui-1.0.24.tar.gz
Algorithm Hash digest
SHA256 f7b5460eb780a00bb0d6f5ee1a3989bb26ac5d7bb5fd4556711257ab2ca18fed
MD5 f5b34bbf257c3ce32be66db8fa876ec8
BLAKE2b-256 20572aac41029a9fb1e7306b5f43d2c9ac11e9883cb0f0765873a5bb475b1565

See more details on using hashes here.

Provenance

The following attestation bundles were made for xed_tui-1.0.24.tar.gz:

Publisher: publish-pypi.yml on XED-dev/TUI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for xed_tui-1.0.24-py3-none-any.whl
Algorithm Hash digest
SHA256 2e0c42ed3e50d72d9a59c2318d7ba6561a02bf0d92d721a914532ccc877f7c88
MD5 5ba81708e2fa1b5fd43d69637c1aa919
BLAKE2b-256 f756150073f5da0fa4937a32708a3add2343aa009a4bf2ea57217e46deb75622

See more details on using hashes here.

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

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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