faustus

🛎️ 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:

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. Use n/N to navigate between matches.

Data Location

Sessions are stored in ~/.claude/projects/. Binned sessions are moved to ~/.claude/faustus-trash/.

Licence

This project is licensed under the GNU General Public License v3.0.