bkmr

Beyond Bookmarks: A CLI Knowledge Management System

bkmr reborn

bkmr is a blazing-fast, feature-rich command-line tool that extends far beyond traditional bookmark management. Store, organize, find, and interact with:

• Web URLs with automatic metadata extraction
• Snippets of code or text
• Local files and directories
• Shell commands for automation
• Documentation with embeddings for semantic search

Why bkmr?

• Lightning-fast: 20x faster than similar Python tools
• Intuitive: Built for developer workflows with powerful search
• Flexible: Handle any type of content — not just web URLs
• Intelligent: Full-text and semantic search capabilities
• Privacy-focused: Local database, no cloud dependencies

Core Features

# Quick fuzzy search with interactive selection
bkmr search --fzf

# Advanced filtering with tags
bkmr search -t python,security "authentication"

# Add web URLs with automatic metadata
bkmr add https://example.com tag1,tag2  # title, description, etc will be loaded automatically

# Store code snippets
bkmr add "SELECT * FROM users WHERE role = 'admin'" sql,snippet --type snip

# Execute shell commands via bookmark
bkmr add "shell::find ~/projects -name '*.go' | xargs grep 'func main'" tools,search

# Semantic search with AI
bkmr --openai sem-search "containerized application security"

Bookmarks

Snippets

Demos

See bkmr in action:

• Getting Started
• Search and Filter
• Edit and Update
• Tag Management

Getting Started

1. Install:

   cargo install bkmr
   
   # or via pip/pipx/uv
   pip install bkmr
   
   # or via brew
   brew tap sysid/bkmr
   brew info bkmr
   
   

2. Setup:

   # Configuration 
   bkmr --generate-config > ~/.config/bkmr/config.toml
   
   # Create database
   bkmr create-db ~/.config/bkmr/bkmr.db
   
   # Optional: Configure location (override config.toml)
   export BKMR_DB_URL=~/path/to/db
   

3. Start using:

   # Add your first bookmark
   bkmr add https://github.com/yourusername/yourrepo github,project
   
   # Find it again
   bkmr search github
   

Command Reference

Advanced Features

• Template interpolation: Use Jinja-style templates in URLs and commands
• Content embedding: Store semantic representations for AI-powered search
• Custom actions: Configure custom behaviors for different content types
• Multiple output formats: Terminal display, clipboard, or JSON export

For detailed documentation on advanced features:

• Configuration Options
• Content Types
• Template Interpolation
• Advanced Usage

Workflow Integration

bkmr shines as the central hub for your technical knowledge and daily workflow:

1. Store information once, find it instantly - Never lose important URLs, commands, or snippets
2. Reduce context switching - Launch applications, files, and commands directly from search
3. Build a personal knowledge base - Accumulate and organize technical references
4. Automate repetitive tasks - Turn complex command sequences into simple bookmarks

Upgrading from Previous Versions

If you're upgrading from a previous version, bkmr will automatically handle database migration to add support for newer features.

Community and Contributions

We welcome contributions! Please check our Contributing Guidelines to get started.