# Getting Started
Get up and running with bmrk in five minutes.
## Quick Start
After installation, launch the interactive tree from the current directory:
```bash
bm
```
Navigate with `j`/`k` (or arrow keys), press `q` to exit and cd to the selected directory,
or `Esc` to exit without changing directory.
## First Launch
When you launch bmrk for the first time:
1. The TUI opens showing the current directory tree (8 rows inline)
2. A configuration file is auto-created at the config location
3. Use arrow keys or `j`/`k` to navigate
4. Press `Enter` to enter a directory (makes it the new root)
5. Press `q` to exit and cd there, or `Esc` to exit without navigating
## Basic Navigation
```
j or ↓ Move down
k or ↑ Move up
l or → Expand directory
h or ← Collapse directory; go to parent if already collapsed
(on the root row itself, always goes straight to the parent)
Enter Change root to selected directory
u Go to parent directory
Backspace Go back (undo last navigation)
q Exit and cd to selected directory
Esc Exit without changing directory
```
## Quick Jump
```
Tab Activate quick jump (type a folder name to jump straight to it)
Type a folder name — jumps to the first match automatically
Shift+Tab Cycle to the next match, if more than one
/ Lock the search to the matched folder's subtree and expand it
Esc Cancel — restores the tree exactly as before Tab
Tab / Enter Confirm and exit quick jump
```
No results list, no fuzzy scoring — just type and land. See [Features](./features.md) for the
full narrowing (`/`) workflow.
## Searching
```
/ Enter search mode
Type your query (matches folder and file names)
Enter Execute search
j/k Navigate results
Enter Jump to selected result in tree
q Exit and cd to selected result
Esc Close search
```
Search matches folder **and file** names — not full paths, not file content. Since the tree
itself stays directory-only, a file result jumps to/selects its containing folder instead.
## Bookmarks
```
m Create bookmark for current directory
' Open bookmark selection menu (apostrophe)
```
Inside bookmark selection:
```
j/k Navigate bookmarks
Enter Jump to selected bookmark
q Exit and cd to selected bookmark
Tab Toggle filter mode
d d Delete bookmark (press twice to confirm)
Esc Close
```
## Disk Selection
```
d Open disk/drive selection panel
j/k Navigate disks
Enter Switch to selected disk root
q Exit and cd to selected disk root
Esc Close without navigating
```
## Your First Workflow
### 1. Navigate to a Project
```bash
bm # Open from anywhere
# Navigate with j/k, expand with l
# Press Enter on your project directory
# Press q to exit and cd there
```
### 2. Create a Bookmark
```bash
bm ~/projects/webapp
# Press 'm' to create a bookmark
# Type a name: webapp
# Press Enter to save
# Press q to exit
```
### 3. Use the Bookmark
```bash
# From anywhere — no TUI needed:
bm webapp
# Or inside bm:
bm # Open TUI
# Press ' (apostrophe)
# Navigate to 'webapp', press Enter or q
```
## Configuration File
Config is auto-created on first run:
- **Linux/macOS**: `~/.config/bmrk/config.toml`
- **Windows**: `%APPDATA%\bmrk\config.toml`
Delete it to reset to defaults — it will be recreated on next run.
## Getting Help
Run `bm -h` for the embedded help reference (all keys, config paths, CLI options).