// the find
gnebbia/kb
A minimalist command line knowledge base manager
kb is a CLI tool for managing a personal knowledge base — think cheatsheets, pentest procedures, and notes stored as flat files with metadata (title, category, tags) in a local SQLite database. It's aimed at security folks and developers who want their notes searchable and syntax-highlighted without leaving the terminal.
The flat-file storage model means your notes are actual files on disk, not locked in a proprietary format — export and backup are trivial. Tag and category filtering plus regex grep across the entire base is genuinely useful when you have 200+ cheatsheets and need to find the one covering a specific protocol. Template system for syntax highlighting is a practical touch: you define TOML rules mapping regexes to colors, so a pentest cheatsheet and a Lisp snippet can have different highlight schemes. Git sync (even labeled experimental) at least gives you a path to multi-machine use without third-party sync tools.
The git sync is marked experimental and has been for years — the repo is five years old and still at v0.1.8, which tells you something about the pace of development. SQLite as the metadata store plus flat files as the content means you can get the two out of sync if you ever touch the files directly, and there's no reconciliation command. No full-text search across content at query time — grep works but it's a subprocess call, not indexed. The Travis CI badge is broken (Travis dropped free tier) and there's a known `attr`/`attrs` conflict in the FAQ that suggests the dependency management hasn't aged well.