Tuiboard

tuiboard

A terminal **kanban** board on plain markdown files, with three optional panels you switch on or off: a **Today/Tomorrow planner** across all your boards, a **24-hour agenda** with a read-only Google / Microsoft 365 calendar overlay, and a **live view of your Claude Code sessions**. Run it as a pure kanban, or any mix of the four. The board is always on; the rest is opt-in (see [Zones](#zones)).

Built with [OpenTUI](https://opentui.com) + SolidJS on Bun. Cross-platform (Linux, macOS, Windows). No vendor lock-in: boards are CommonMark with the Obsidian Tasks-plugin emoji vocabulary, so they open and edit fine in any markdown editor.


Install

Requires [Bun](https://bun.sh) ≥ 1.2 — tuiboard runs on the Bun runtime (it's not a Node CLI). OpenTUI ships its own native renderer binaries; Bun picks the right one for your platform automatically. Pick whichever install fits:

**Global, straight from GitHub** (no npm needed) — run `tuiboard` from anywhere:

bun install -g github:NazzarenoGiannelli/tuiboard
tuiboard

**Global, from npm:**

bun install -g tuiboard      # or run once, no install: bunx tuiboard

**From source** (for hacking on it):

git clone https://github.com/NazzarenoGiannelli/tuiboard.git
cd tuiboard
bun install
bun run dev          # or: bun link  → then `tuiboard` globally, live-linked

Quick start

Starting fresh — no Obsidian, no special folders required:

1. Install Bun (bun.sh), then bun install -g tuiboard.
2. Make one or more board files. A board is a plain .md file: every ## heading is a column, every - [ ] line is a task. The simplest board:

   ## To Do
   - [ ] My first task
   
   ## In Progress
   
   ## Done

   Create one file per tab you want (e.g. Work.md, Personal.md). Column