🛎️ Faustus
A beautiful TUI for managing Claude Code sessions
Features
- Browse Sessions: View all your Claude Code conversation sessions
- Filter: Filter session list by summary, prompt, project name
- Deep Search: Search through all session content (messages, code, etc.)
- Preview Pane: View conversation content with search highlighting
- Delete: Move sessions to bin (recoverable)
- Restore: Recover sessions from bin
- Rename: Update session summaries
- Reassign Folder: Move sessions when project folders are relocated
- Bin Management: Empty bin to permanently delete sessions
Installation
go install github.com/Fuwn/faustus@latest
Or run with Nix:
nix run github:Fuwn/faustus
Or build from source:
git clone https://github.com/Fuwn/faustus.git
cd faustus
task build
task install
Usage
faustus
Keybindings
Vim-style navigation:
| Key | Action |
|---|---|
j/k |
Navigate down/up (or scroll preview when focused) |
h/l |
Switch tabs (Sessions ↔ Bin) |
gg/G |
Jump to top/bottom |
C-u/C-d |
Half page up/down |
/ |
Filter list (or search in preview when focused) |
s |
Deep search across all session content |
n/N |
Next/previous search match |
p |
Toggle preview pane |
tab |
Switch focus between list and preview |
d |
Delete (move to bin) |
u |
Restore from bin |
c |
Change name (rename) |
r |
Reassign folder (single session) |
R |
Reassign folder (all matching sessions) |
D |
Clear bin |
? |
Toggle help |
q |
Quit |
Search
- Filter (
/): Filters the session list by summary, first prompt, and project name. When the preview is focused, searches within the current preview. - Deep Search (
s): Searches through all message content across all sessions. Results show context around matches. Usen/Nto navigate between matches.
Data Location
Sessions are stored in ~/.claude/projects/. Binned sessions are moved to ~/.claude/faustus-trash/.
Licence
Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.