nazzarenogiannelli/tuiboard

tuiboard is a terminal dashboard for managing tasks stored in plain markdown files. It runs in the command line and combines several views in one interface: a kanban board showing tasks organized into columns, a Today and Tomorrow panel for short-horizon planning, a 24-hour agenda, and a live view of any Claude Code AI agent sessions currently running. All task data lives in ordinary markdown files, so the same files open and edit normally in any text editor or note-taking app. Tasks follow a simple format: section headings define columns, and lines starting with a checkbox define tasks. A file with columns named To Do, In Progress, and Done becomes a functional kanban board. The project uses the same task emoji vocabulary as the Obsidian Tasks plugin, which means files are compatible with Obsidian without conversion. Columns named Done and Archive are treated specially: they are hidden from the main board view but used by the done-statistics and archive features. The calendar overlay lets users connect a Google Calendar or Microsoft 365 account to display events as read-only blocks in the 24-hour agenda view. Setup involves creating a standard OAuth client in Google Cloud or Azure, running a built-in setup command that handles the authentication flow, and pasting a small YAML block into the config file. Events are cached on disk and refreshed in the background every five minutes. A missing or expired calendar connection does not break the rest of the dashboard. The agent view requires no configuration. It reads Claude Code session data from the standard Claude local folder automatically. The tool is built on the Bun JavaScript runtime and a terminal UI framework called OpenTUI. It runs on Linux, macOS, and Windows, and installs via npm or directly from the GitHub repository using Bun.