tabby-tab-notes
v0.1.1
Published
Persistent per-tab markdown notes for Tabby
Readme
tabby-tab-notes
A Tabby terminal plugin: persistent per-tab markdown notes in a docked side panel, with an auto-stamped context header (cwd + git branch), optional repo-pinning, and plain-file storage that can roam between machines. It's a handoff doc for you — so when you come back to a tab you remember what you were doing and what's next.
Status: working
Verified live on Tabby (macOS):
- Docked notes panel, toggled from the toolbar button (or the
tab-notes-togglehotkey) - A separate note per tab, switching automatically as you change tabs
- Auto-stamped header showing the tab's working directory and git branch
📌 Pina note to its repo so any tab in that repo shares it (hybrid binding)- Notes stored as plain
.mdfiles (default~/.config/tabby/tab-notes/) - Notes survive a full restart and reattach to the correct tabs
Install
See INSTALL.md. In short: npm install --legacy-peer-deps && npm run build, symlink into Tabby's plugin dir, enable "restore tabs on startup".
Design & build history
- Design spec:
docs/specs/2026-06-05-tabby-tab-notes-design.md - Implementation plan:
docs/plans/2026-06-05-tabby-tab-notes.md
Known rough edges
- Default notes folder is
~/.config/tabby/tab-notes/on all platforms (works, but not Tabby's native config dir on macOS/Windows); repoint it via thetabNotes.folderconfig for synced/cross-machine use. - The header's "last command" field is reserved but not yet populated (would need shell integration).
- Panel is a fixed overlay on the right edge; it covers part of the terminal rather than reflowing it.
