Editor
Only the line you are on shows its source.
A note is one Markdown file. Headings, lists, tasks, code and quotes render in place as you leave each line.
- Plain files, nothing hidden.
- Templates and prompts are files too.
Lumbridge Work
Gated · opens on November 13, 2026Lumbridge Notes Markdown notes in a terminal pane.
Lumbridge Notes is a Markdown note editor that runs in any terminal and shows the formatted note while you type. Each note is one plain file in a folder, so people, scripts and agents can all read and write the same notebook. AI prompts, reading aloud and dictation are optional and use servers you name.
Tour
See Notes at work.
Search
Search every note in the folder.
Each hit shows the note and the line. Shown in both themes.
01 · What it does
What Notes does today.
Live preview as you type
Headings, lists, task boxes, tables, quotes and code are drawn formatted. The line under the cursor shows its Markdown source, and a source mode shows the whole file raw. Undo, redo, find and mouse clicks work as you expect.
Plain files, nothing hidden
One Markdown file per note, with optional TOML front matter for title, tags and created date. YAML-style front matter is tolerated. Saves are atomic, a change made by another program is detected, and unsaved text goes to a recovery file if the pane closes.
Picker and search
Ctrl-O opens a fuzzy picker over the notebook, newest first. Ctrl-G searches the full text of every note. Ctrl-N starts a new note, and a note’s title, heading and file name can be changed together.
Templates and prompts are files too
Templates and AI prompts are Markdown files inside the notebook, under .lumbridge/templates and .lumbridge/prompts. A starter set is written once: daily, meeting, idea, project and agent brief templates, and prompts such as summarize and extract tasks. Add your own, or let an agent add them.
AI on a server you choose
Ctrl-K runs a prompt on the note or the selection against any OpenAI-compatible chat server. The answer streams into a panel under the note, and you choose to replace, insert or append it; Ctrl-Z undoes it. Untitled notes can be named automatically. With no server set, the editor says how to add one.
Read aloud and dictate
Ctrl-R reads the note through an OpenAI-style speech endpoint and marks the lines being read. Ctrl-D records from the microphone and types what you said, either after you stop or word by word over a streaming connection.
02 · How it works
One crate, core first
The crate is a library and one binary. The core modules do no terminal I/O, which is why the note format can be tested byte for byte.
- 2.1
Text core
A buffer with cursor, selection and undo; Markdown-aware edits such as list continuation and task toggling; a per-line parser that maps rendered spans back to source; and a layout pass for soft wrap and scrolling.
- 2.2
Store and notebook
Loading, atomic saving, front matter and the notebook folder live in one module. A golden test suite pins the note format, including line endings, byte order marks and odd front matter, so the editor and the terminal’s notebook drawer always agree. A new notebook gets an AGENTS.md guide for agents that write notes.
- 2.3
App and rendering
Application state handles keys and mouse; rendering is a pure function from that state to a ratatui frame. Copy uses the terminal’s OSC 52 clipboard, so it also works over SSH. NO_COLOR and a light or dark theme variable are honoured.
- 2.4
Assistants off the main thread
AI, speech and dictation jobs each run on their own thread, so typing never waits on the network. HTTP goes through curl and audio through the system’s command-line audio tools. A result for a job you have canceled is dropped.
03 · Use it
Open a note or a notebook
There is one command. Give it a file to edit, a folder to pick from, or nothing to open the default notebook.
cargo install --path .
lumbridge-notes # pick from ~/notes
lumbridge-notes --dir ~/work-notes # another notebook
lumbridge-notes ~/work-notes/plan.md # created on first save
LUMBRIDGE_NOTES_THEME=light lumbridge-notes --dir ~/work-notes
ls ~/work-notes/.lumbridge/templates ~/work-notes/.lumbridge/prompts
# ~/.config/lumbridge-notes/config.toml (every section is optional)
[ai]
url = "http://models.acme.example:8001/v1"
model = "brain"
auto_name = true
[speech]
url = "http://speech.acme.example:8097/v1"
04 · Docs
The Notes manual.
These pages are in the repository and open with it. Until then, the Guide covers the same ground and is readable now.
- 01
Build and run
Build from source with cargo, the command line, and the notebook folder it opens by default.
- 02
Keys
Every shortcut: save, picker, search, find, source mode, tasks, the AI menu, templates, read aloud and dictation.
- 03
Note format
Markdown with optional TOML front matter, slug file names, and the golden suite that pins the format.
- 04
Configuration
The [ai], [speech] and [dictation] sections of config.toml, the environment variables and the color settings.
- 05
Templates and prompts
Where they live in the notebook, their front matter, the placeholders, and the prompt actions replace, insert, append and answer.
Read the Guide chapter: Work appsRequest access to the repository
05 · Works with
One part of one system.
- Lumbridge TUIThe terminal’s notebook drawer opens notes in lumbridge-notes in a pane, and both share one note format.
- Lumbridge ModsThe notebook mod lists the folder in a panel and opens a note with lumbridge-notes --dir <dir> <file> in a split.
- Lumbridge SpeakRead aloud posts the note’s text, cut into chunks, to an OpenAI-style /audio/speech endpoint.
- Lumbridge VoiceDictation posts recordings to /audio/transcriptions, or streams microphone audio and gets words back live.
Not yet
- No installer, packages or updater: you build from source.
- Read aloud and dictation look for Linux audio tools by default; on macOS you set the play and record commands yourself.
- Live dictation speaks plain ws:// only, so it is meant for a private network.
- No sync of its own. Share a notebook with git or a synced folder.
Questions
Questions about Notes.
Where are my notes stored?
In a folder of Markdown files, ~/notes by default or the folder you pass with --dir. There is no database and no account. Templates and prompts sit in a .lumbridge folder inside the same notebook.
What is sent to a model?
Nothing unless you set a server and ask. With an [ai] url set, a prompt sends the note or the selection to that server. If auto_name is on, an untitled note is also sent to be named. Reading aloud sends the note’s text to your speech server, and dictation sends your recording.
Does it work without any AI server?
Yes. Editing, preview, the picker, search and templates need no network. The AI, speech and dictation buttons tell you how to set a server up when none is configured.
Can agents use the same notebook?
Yes. Notes are plain files, so an agent writes Markdown into the folder and the editor notices the change. A new notebook gets an AGENTS.md guide that explains the format, and agents can add templates and prompts as files.
What does it run on, and under what license?
Any Unix terminal on Linux or macOS, locally or over SSH. It is a single Rust binary. The code is Apache-2.0 and the repository opens on November 13, 2026.
Want Notes running for your team?
Self-host it, or talk to us about setting it up with you.