bmrk 0.2.1

A fast TUI for directory navigation and bookmark management
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

# bmrk — Demo Gallery

Visual demonstrations of bmrk features and functionality.

---

## Tree Navigation

Navigate through directories with vim-style keybindings. Expand/collapse with `l`/`h`,
move with `j`/`k`, enter directories with `Enter`, go to parent with `u`, go back with `Backspace`.

![Tree Navigation Demo](assets/tree_navigation.gif)

*Demo: Basic tree navigation and directory exploration*

---

## Fuzzy Search

Two-phase search: instant scan of loaded nodes, then deep background search across the
full tree. Normal (`query`) and fuzzy (`/query`) modes with ranked results.

![Search Demo](assets/search.gif)

*Demo: Folder-name search with fuzzy matching*

---

## Bookmarks

Create bookmarks with `m`, manage with CLI (`bm -l`, `bm -a`, `bm -d`),
jump instantly with `bm bookmarkname` or via the selection menu (`'`).

![Bookmarks Demo](assets/bookmarks.gif)

*Demo: Creating and using bookmarks*

---

## Key Features Shown

### Navigation
- ✅ Vim-style keybindings (j/k/h/l)
- ✅ Tree expansion/collapse
- ✅ Directory traversal and root change (Enter)
- ✅ Navigation history and undo (Backspace/u)
- ✅ Disk/drive selection (d)

### Search
- ✅ Folder-name search (/ key)
- ✅ Fuzzy matching (/query prefix)
- ✅ Background async search
- ✅ Result navigation
- ✅ Exit and cd to result (q)

### Bookmarks
- ✅ Create bookmarks (m key)
- ✅ Browse bookmarks (' key)
- ✅ CLI management (bm -l / -a / -d)
- ✅ Quick navigation (bm bookmarkname)
- ✅ Filter mode (Tab)

---

## More Information

- **[README](../README.md)** — Full documentation
- **[Key Bindings](./keybindings.md)** — Quick reference / cheatsheet

---

**Back to [README](../README.md)**