mnemo

A personal knowledge vault for your terminal. Store notes, code snippets, and links with tags - all searchable from the command line.

Features

• Notes - Quick thoughts and reminders with tags
• Snippets - Code snippets with syntax highlighting
• Links - Bookmark URLs with metadata
• Search - Full-text search across everything
• Tags - Organize and filter by tags
• Clipboard - Copy to/capture from clipboard
• Export - Export vault to markdown

Installation

cargo install --path .

Or build from source:

cargo build --release
cp target/release/mnemo ~/.local/bin/

Usage

Initialize

mnemo init

Notes

# Add a note
mnemo note add "Remember to review PR #42" -t work,todo

# List notes
mnemo note ls

# Delete a note
mnemo note rm abc123

Snippets

# Add a snippet
mnemo snippet add "git undo" "git reset --soft HEAD~1" -l bash -t git

# List snippets
mnemo snippet ls
mnemo snippet ls -l rust  # filter by language

# Show snippet code
mnemo snippet show abc123

# Delete a snippet
mnemo snippet rm abc123

Links

# Add a link
mnemo link add "https://github.com" -t "dev,tools"

# List links
mnemo link ls

# Delete a link
mnemo link rm abc123

Search

# Search across notes, snippets, and links
mnemo search "docker"

Tags

# List all tags with counts
mnemo tags

# Filter items by tag
mnemo tags filter work

Clipboard

# Copy snippet to clipboard
mnemo copy snippet abc123

# Copy note to clipboard
mnemo copy note abc123

# Capture clipboard as note
mnemo capture

# Capture clipboard as snippet
mnemo capture --snippet -l python -t automation

Stats & Export

# Show vault statistics
mnemo stats

# Export to markdown
mnemo export -o vault-backup.md

Data Location

Your vault is stored locally at:

• Linux/macOS: ~/.local/share/mnemo/vault.db
• Windows: %LOCALAPPDATA%\mnemo\vault.db

License

MIT

Demo recorded with termgif