nightshade-research/lotus-tui

Lotus TUI is an OCaml companion program for Lotus, an Obsidian plugin that lets people run executable code blocks embedded inside their Markdown notes. This project gives you a terminal based interface, a command line tool, and a background service, all of which talk to Lotus through the same local, signed API rather than through Obsidian's own interface. There are two main ways to use it. The normal path connects to Obsidian while it is open with the Lotus plugin's local API turned on, letting you browse notes, view code blocks, and run them from the terminal instead of clicking around inside Obsidian. The other path, called headless mode, runs entirely without Obsidian: Lotus TUI starts its own background daemon that serves a folder of Markdown notes directly, using the exact same API, so a note vault can be worked with from a server or a machine that never opens Obsidian at all. Once connected, the terminal interface lets you browse your notes, look at individual code blocks, edit them in a built in text editor, and run them, with a policy setting that controls whether the output of a run gets written back into the note or just shown on screen. Unsaved edits are automatically kept in a recovery folder so a draft is not lost if the program closes unexpectedly. The headless daemon can execute code blocks written in many languages, including Python, JavaScript, TypeScript, Ruby, Go, Rust, C, and several more, by calling out to whichever matching interpreter or compiler is already installed on the system. Every request between the terminal tool and the API is authenticated with a signed header built from a secret key, a timestamp, and a hash of the request body, checked using a comparison method designed to resist timing based attacks, and timestamps are only accepted within a five minute window. The project is installed and built using OCaml's package manager and build tool, and it is released under the MIT license.