01 · the board
A kanban board that lives in a text file.
Every column is a markdown heading, every card a task list item. tuiboard renders it as a fast, navigable board — move cards, set due dates, flag priority — and writes it straight back to disk. Quit, and you still have a readable to-do list you can open in Obsidian, cat, or diff in git. Nothing is trapped.
- Obsidian Tasks emoji vocabulary out of the box — ⏳ scheduled · 📅 due · 🔼 priority ·
- [x]done - Multiple boards, switch with a keystroke; filter, reorder, archive
- Move cards with the keyboard, or drag them with the mouse — your call
- The file updates as you go, so your editor and your TUI never disagree
## In Progress - [ ] Ship v0.8 agenda write 📅 2026-06-12 🔼 - [x] Wire Google OAuth ## Backlog - [ ] USD pipeline notes ⏳ 2026-06-20
↳ this markdown renders as the board on the right
02 · today / tomorrow
One place for everything you said you'd do.
Flip on the planner and tuiboard scans every board, pulls out what's scheduled, and lays Today and Tomorrow side by side. No re-typing, no second app — it just reads the ⏳ and 📅 dates you already wrote.
- Aggregates ⏳ scheduled + 📅 due across all boards
- Today / Tomorrow split, sorted and de-duplicated
- Stays in sync — edit a card anywhere and the planner updates
- Pure opt-in: run tuiboard as a plain kanban and never see it
03 · 24-hour agenda
A real agenda — that writes back to your calendar.
The agenda lays your day on a 24-hour rail and overlays your Google or Microsoft 365 events on your scheduled tasks. As of v0.8 it's two-way — create, edit and delete Google events inline: title, time, date, all-day, target calendar. Your tokens stay on your machine, and write access is opt-in.
- Google + Microsoft 365 events overlaid on a 24h timeline
- Create / edit / delete Google events inline — keys:
nnew ·eedit ·ddelete - Pick target calendar, time, date, all-day flag
- Bring-your-own-credentials, stored locally, write scope opt-in
04 · live agents
See every Claude Code session you're running. Resume one with Enter.
tuiboard finds your local Claude Code sessions and shows them live — status, git branch, last activity. Hit Enter on a row and you're back in that session. Your board, your day, and your agents in one window.
- Live status, git branch, and last-activity per session
- Press
↵to resume any session in place - Configurable resume command (e.g. open in WezTerm)
- Local-only — nothing leaves your machine
This is the panel that started it all — built to run my own multi-agent days.
One board, or all four. Your call.
Start as a plain kanban. Switch on the planner when you want a daily focus, the agenda when you live by your calendar, the agents panel when you're deep in Claude Code. Any mix — it's the same markdown underneath.
[x] kanban ...... always on [x] planner ...... today / tomorrow [x] agenda ...... 24h + calendar [ ] agents ...... claude code sessions
flip panels on and off — your layout, your call.
05 · install
Up and running in one line.
$ bun install -g tuiboard
↳ then run tuiboard anywhere
$ bunx tuiboard
↳ try it without installing
$ bun install -g github:NazzarenoGiannelli/tuiboard
↳ latest from main
Requires Bun ≥ 1.2. Calendar features need a Google or Microsoft 365 connection — set up with tuiboard calendar-setup; credentials stay local. Then run tuiboard in any folder with markdown boards, or let it scaffold one.
Plain text in. Your day, organized. Nothing locked away.
Run it as a pure kanban, or turn on the planner, agenda, and agents one at a time. Your board, your files, your terminal.
$ bun install -g tuiboard
Built by Nazzareno Giannelli · nazzareno.xyz