xwmx/nb
Nb
nb is a command-line note manager and personal knowledge management system that organizes plain-text documents and web bookmarks. It functions as a Markdown knowledge base, allowing users to create a structured collection of information through a shell-scripted interface.
The system uses Git for versioning and synchronization, tracking full revision history and enabling the sync of notebooks across multiple devices via remote repositories. It provides security for sensitive data through AES-256 or GPG encryption and supports document conversion into various publishing formats using the Pandoc engine.
The toolset covers broad content management capabilities, including wiki-style bidirectional linking, hierarchical tagging, and full-text search with regular expressions. It also includes utilities for task tracking through todo lists, bookmark generation from URLs, and a dynamic plugin architecture for adding custom subcommands and themes.
The application is implemented as a portable shell script and includes a dedicated interactive shell environment with command-line completion.
Features
- Personal Knowledge Management - Provides a comprehensive system for capturing, organizing, and retrieving personal notes and bookmarks via a structured knowledge base.
- Knowledge Base Management - Implements a complete system for organizing and searching local document collections to maintain a structured knowledge base.
- Git-Based - Uses a background Git repository to track full revision history and synchronize notebooks across devices.
- CLI Wrappers - Implements the primary interface as a portable shell script managing subcommands and interactive environments.
- Password-Based Encryption - Provides AES-256 or GPG encryption to secure sensitive plain text notes and bookmarks.
- Local-First Note Taking - Provides a local-first, command-line interface for managing a knowledge base of notes and bookmarks.
- Note Editors - Integrates with system editors or browser forms to edit notes with automatic re-encryption upon saving.
- Bidirectional Linking - Uses double-bracket syntax to create a navigable network of bidirectional links between notes and bookmarks.
- Note-Taking Systems - Provides a system for managing text-based content using Git for versioning and synchronization.
- Markdown-Based Knowledge Bases - Organizes interconnected notes using Markdown files and wiki-style bidirectional linking in a version-controlled repository.
- Content Tagging Systems - Uses labels and hashtags to categorize notes and bookmarks for improved discovery and retrieval.
- Plain-Text Persistence - Stores all notes and bookmarks as individual files in a directory structure to ensure data portability.
- Remote Repository Syncing - Synchronizes notebooks with remote Git repositories using orphan branches to store multiple notebooks in one remote.
- Revision Histories - Commits every change to a background Git repository to maintain a full revision history of every item.
- Note Management Utilities - Implements a command-line interface for creating, tagging, and searching plain text documents and bookmarks.
- Git-Based Repositories - Uses Git-based repositories to track full revision history and synchronize notebooks across multiple devices.
- Internal Wiki Linking - Allows navigation of the knowledge base using bidirectional links and hashtags as an internal wiki.
- Creation Workflows - Enables generation of new plain text notes via the command line or browser using templates and pipes.
- Hierarchical Organization - Groups notes and bookmarks into a hierarchical directory structure for logical organization.
- Notebook Management - Manages multiple independent notebooks, each with its own version history and archival settings.
- Integrated Task Lists - Provides structured Markdown todo lists integrated directly into the knowledge management workflow.
- Metadata Extraction - Generates structured Markdown bookmarks from URLs by extracting page metadata and adding custom tags.
- Task State Tracking - Tracks the completion status of tasks across documents, allowing items to be marked as open or closed.
- Document Exporting - Enables the export of notes and bookmarks into various portable formats via an automated conversion engine.
- Document Conversion - Integrates the Pandoc engine to transform plain text notes into various publishing formats.
- Document Format Converters - Includes utilities to convert plain text notes into multiple publishing formats via the Pandoc engine.
- Document Format Conversions - Transform plain text notes into various publishing formats using an integrated conversion engine like Pandoc.
- Full Text Search - Enables complex text searches across the knowledge base using regular expressions, Boolean operators, and hashtags.
- Hierarchical Tags - Supports nested labels and hashtags to create multi-dimensional taxonomies for organizing notes and bookmarks.
- Notebook Initialization - Converts system folders into version-controlled notebooks by initializing a Git repository and index file.
- Shell Execution Environments - Provides a dedicated interactive shell environment to execute subcommands without repeating the base command.
- Encrypted Archiving Tools - Secures sensitive data using AES-256 or GPG encryption to create a private, encrypted archive of notes.
- Document Encryption - Secures sensitive notes and bookmarks using AES-256 or GPG encryption to prevent unauthorized access.
- Plugin Architectures - Implements a dynamic architecture allowing users to extend functionality via external scripts and custom themes.
- Plugin Architectures - Allows extending the application by adding new subcommands and design themes through local or remote plugin files.
- Metadata Filtering - Displays notes and bookmarks sorted by modification date and filtered by type, domain, or search patterns.
- Terminal Content Rendering - Renders notes directly in the terminal with syntax highlighting or opens them in external GUI applications.
- Notes and Management - Provides encrypted note-taking, archiving, and versioning in the terminal.
- Task Management - Note-taking and knowledge base application.
- Terminal Note Tools - CLI-based application for notes, bookmarks, and knowledge base management.
