home / dev-tools / nb

nb

8k

Plain-text knowledge base CLI for creating, searching, browsing, and syncing notes, bookmarks, and todos.

$brew install xwmx/taps/nb
Language
Shell
Stars
8,042
Category
Dev Tools
Agent
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, and search --list make 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
  • browse depends on pandoc plus ncat or socat, and richer terminal rendering relies on optional tools like w3m, links, or bat.
  • Some workflows default to human tools such as your editor, pager, GUI browser, or password prompts for encrypted notes and private Git remotes.