Home
bkmr is a unified CLI store for URLs, code snippets, shell scripts, documents, and environment variables — all in one local SQLite database with full-text search, semantic search, and fuzzy finding. It works identically for interactive human use and programmatic agent access.
Local-first, offline, no API keys needed.
| Problem | How bkmr solves it |
|---|---|
| Snippets scattered across editors, notes, wikis | One searchable database, accessible from CLI and editors (LSP) |
| Shell scripts lost in dotfiles or history | Store, tag, execute with arguments — generate shell function stubs |
| Can't find that URL you bookmarked months ago | Full-text search, tag filtering, semantic search by meaning |
| Environment configs differ across machines | Store env sets, switch with eval "$(bkmr open <id>)"
|
| AI agents lack persistent memory across sessions |
_mem_ content type: store/query/deduplicate agent memories |
| For Humans (Interactive CLI) | For Agents (Programmatic API) |
|---|---|
Interactive fuzzy search (--fzf) |
JSON output (--json --np) |
| Browser/clipboard actions | stdout output (--stdout) |
| Editor integration (LSP server) | Bulk import (load-json) |
| Shell script execution with editing | Memory system (_mem_) |
| Semantic search (fully offline) | Hybrid search for natural language queries |
- Getting Started — Install and run your first commands
- Core Concepts — Bookmarks, tags, content types, search methods
- Agent Integration — Use bkmr as agent memory and knowledge store
| Command | Description |
|---|---|
bkmr add <url> <tags> |
Add a bookmark |
bkmr search <query> |
Full-text search |
bkmr search --fzf |
Interactive fuzzy search |
bkmr hsearch <query> |
Hybrid search (FTS + semantic with RRF) |
bkmr sem-search <query> |
Semantic search (local, offline) |
bkmr open <id> |
Open/execute bookmark |
bkmr edit <id> |
Edit bookmark (smart editing) |
bkmr update <id> |
Update tags or custom opener |
bkmr show <id> |
Show bookmark details |
bkmr delete <id> |
Delete bookmark |
bkmr tags |
List all tags |
bkmr import-files <path> |
Import files with frontmatter |
bkmr info |
Show config and embedding status |
bkmr load-json <file> |
Import bookmarks from JSON array |
bkmr lsp |
Start LSP server for editor integration |
bkmr completion <shell> |
Generate shell completions |