nb is a command-line and local web note-taking, bookmarking, and archiving application built as a single portable shell script.
The tool addresses the need for a lightweight, self-contained system to organize notes, bookmarks, and knowledge without external dependencies or cloud services. It stores all data as plain text files, enabling users to work with formats like Markdown, Org, LaTeX, and AsciiDoc. The approach combines command-line operations with an optional local web interface, allowing users to create, search, tag, and filter content using terminal commands or a browser. Git integration provides automatic version control and syncing with remote repositories, while Pandoc support enables conversion between document formats. Wiki-style linking, encryption, and folder organization allow users to build interconnected knowledge bases.
Developers should choose this tool if they prefer plain text storage, want to avoid cloud dependencies, and value portability and scriptability. It suits individuals building personal knowledge bases, maintaining bookmark collections, or managing notes across multiple devices via Git sync. The tool works in any standard Unix-like environment including macOS and Windows via WSL. Optional dependencies enhance functionality but are not required for core operations. Users can edit notes in their preferred text editor—Vim, Emacs, VS Code, or others—and browse content either in the terminal or through a local web interface.
The project maintains active test coverage with continuous integration workflows. Development activity shows consistent attention to code quality and reliability across the shell script implementation. The tool receives ongoing maintenance and refinement to support its diverse feature set and cross-platform requirements.
