| Crates.io | wanderer |
| lib.rs | wanderer |
| version | 0.1.0 |
| created_at | 2025-12-31 14:38:42.064307+00 |
| updated_at | 2025-12-31 14:38:42.064307+00 |
| description | A minimal, opinionated note-taking TUI optimized for the UNIX philosophy. |
| homepage | https://github.com/fonger900/wanderer |
| repository | https://github.com/fonger900/wanderer |
| max_upload_size | |
| id | 2014820 |
| size | 475,126 |
A minimal, opinionated note-taking TUI.

YYYYMMDD-HHMM.md or YYYYMMDD-HHMM-title.mdgrep to search, shell aliases for "vaults"cargo install --path .
Ensure ~/.cargo/bin is in your PATH.
wanderer # Opens current directory
wanderer ~/notes # Opens specific directory
Wanderer stays flat by relying on LINKS and TAGS to organize information, rather than folders.
This workflow is built into the UI design:
Capture (Inbox)
n and just hit Enter.YYYYMMDD-HHMM.md.Clarify (Process)
r to add a "slug" (e.g., meeting).YYYYMMDD-HHMM-meeting.md.Connect (Network)
[[wikilinks]] and #tags to weave topic notes together.todo.md, projects.md) as Map of Content (MOC) or Dashboards.Just type #tagname anywhere in your note.
#work #meetingSearching tags: Since tags are just text, you can search them easily.
t to fuzzy search tags using fzf.grep "#work" *.md
Connect notes using [[wikilinks]].
Wanderer highlights these in the preview so you can spot connections at a glance.
n$EDITOR (defaults to nvim)Examples:
n → Enter → 20251227-2130.md
n → "weekly review" → Enter → 20251227-2130-weekly-review.md
n → "Project Ideas" → Enter → 20251227-2130-project-ideas.md
j/k or arrows: Navigate file list.md file to preview with syntax highlightingCtrl+d/Ctrl+u: Scroll preview down/upg/G: Jump to top/bottom of notee: Edit in external editorr: Smart Rename.
meeting -> planning), preserving the ID..md only).d: Delete (confirm with y)Wanderer uses a custom markdown parser with support for:
# H1, ## H2, ### H3**bold**, *italic*, `inline code`- or *) and Numbered (1.)[[wikilinks]] and images ```#tagname (highlighted)| Key | Action |
|---|---|
q |
Quit |
n |
New note |
e |
Edit in $EDITOR |
r |
Rename |
d |
Delete |
t |
Search tags |
/ |
Search notes |
j/k |
Navigate file list up/down |
Enter |
Edit selected note / Open |
Ctrl+d / PgDn |
Scroll preview down |
Ctrl+u / PgUp |
Scroll preview up |
g |
Scroll to top |
G |
Scroll to bottom |
Esc |
Cancel current action |
Wanderer is designed for a flat structure. Simple lists are easier to maintain than complex hierarchies.
# Flat (simple)
~/notes/
├── 20251227-2130-meeting.md
├── 20251227-2145-idea.md
└── 20251228-0900-todo.md
Use shell aliases for quick access:
alias notes="wanderer ~/notes"
alias work="wanderer ~/work/notes"
alias journal="wanderer ~/journal"
Wanderer follows UNIX philosophy — use existing tools.
Inside Wanderer:
/ to fuzzy search notes using fzf (must be installed).From the terminal:
# Find notes containing "meeting"
grep -r "meeting" ~/notes/
# Find by filename
find ~/notes -name "*project*"
# Fuzzy find with fzf
find ~/notes -name "*.md" | fzf --preview 'cat {}'
Config file is located at ~/.config/wanderer/config.toml (or equivalent for your OS).
# Display format regarding dates in file list
# Options: "raw" | "compact" (default) | "relative"
date_format = "compact"
# External editor command (optional)
# Defaults to $EDITOR environment variable, then "nvim"
editor = "code"
$EDITOR: Your preferred editor (defaults to nvim)MIT