Plain-text knowledge base CLI for creating, searching, browsing, and syncing notes, bookmarks, and todos.
$brew install xwmx/taps/nb
AI Analysis
nb is a plain-text notebook CLI for managing local notes, bookmarks, todos, folders, and multiple notebooks from the shell. It stores content as normal files, adds Git-backed history and sync, and can serve a local web view for browsing linked notes and archived pages.
What It Enables
- Create, tag, move, and search notes, folders, todos, and notebooks while keeping everything in normal Markdown or other local files.
- Save URLs as bookmark files with extracted page metadata and cached page content, then search archived pages locally or open them in terminal or GUI browsers.
- Browse linked notes through the local web app, export content through Pandoc, and sync notebook repositories through Git remotes.
Agent Fit
- Plain-text storage plus flags like
show --print,show --path,list --paths, andsearch --listmake inspect, edit, and verify loops workable from scripts. - Search, listing, note creation, notebook selection, and sync commands are non-interactive when fully specified, but output is plain text and no JSON mode was found.
- Best fit is a local knowledge base that an agent can script around; browser views, pagers, terminal web browsers, encryption prompts, and Git credentials make unattended automation less clean.
Caveats
browsedepends onpandocplusncatorsocat, and richer terminal rendering relies on optional tools likew3m,links, orbat.- Some workflows default to human tools such as your editor, pager, GUI browser, or password prompts for encrypted notes and private Git remotes.