basalt
Terminal user interface (TUI) for managing Obsidian vaults and notes from the command line
Basalt is a cross-platform terminal user interface for managing Obsidian vaults and notes. It provides a WYSIWYG editing experience directly in the terminal, allowing users to work with their Obsidian knowledge base without leaving the command line environment. The tool runs on Windows, macOS, and Linux.
The application offers a minimalist terminal interface that complements rather than replaces Obsidian. Users can navigate through vaults, edit notes, and manage their knowledge base structure through keyboard-driven navigation. Basalt includes support for custom key mappings and commands through TOML configuration files.
Configuration files can be placed in standard system locations ($HOME/.basalt.toml on Unix systems, %USERPROFILE%.basalt.toml on Windows) or XDG/AppData directories. The tool follows a precedence system where home directory configurations take priority over system-wide settings. Basalt is particularly useful for developers and knowledge workers who prefer terminal-based workflows and want to manage their Obsidian notes without context switching to a GUI application.
Installation
# via Cargo
cargo install basalt-tui
# via Aqua
aqua g -i erikjuhani/basalt
