blob: 242c8ce3a1da1a5e6b131b45de0552ab1155eef3 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
# 🛎️ Faustus
> A beautiful TUI for managing Claude Code sessions
[](https://asciinema.org/a/FApqeZY0R9kWzR07)
## 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
```bash
go install github.com/Fuwn/faustus@latest
```
Or build from source:
```bash
git clone https://github.com/Fuwn/faustus.git
cd faustus
task build
task install
```
## Usage
```bash
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. Use `n/N` to 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](LICENSE-APACHE) or
[MIT license](LICENSE-MIT) 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.
|