tuiboard CLI
tuiboard combines a Markdown kanban, a day planner and a live list of Claude Code, Codex, OpenCode and Pi sessions.
- 132 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The session overview reads local agent data read-only.
- Boards live in the user's own ordinary Markdown files.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/tuiboardDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The session overview reads local agent data read-only.
- Boards live in the user's own ordinary Markdown files.
This is third-party code. Review the repository files before installing.
What it does
`tuiboard` opens kanban boards in the terminal from Markdown files using the emoji vocabulary of the Obsidian Tasks plugin, so any editor reads the same files. Three panels are optional: a today and tomorrow planner across all boards, a 24-hour agenda with blocks you drag with the mouse and an overview of agent sessions. The session overview reads local Claude Code data from `~/.claude/`, Codex from `~/.codex/`, plus OpenCode and Pi, read-only. Each session shows an agent badge, the model and its state, and the `f` key filters the list by agent. The agenda can overlay a Google or Microsoft 365 calendar.
Who it is for. Developers who keep tasks in Markdown and run several agent sessions in the terminal at once.
Good fit when
- Several Claude Code and Codex sessions run at once and you need to see which one waits for you.
- Tasks live in Markdown files next to the code and must stay readable without special software.
- You want to lay out the day in hourly blocks inside the terminal.
- An agent sets up boards from the README prompt while you answer its questions.
Not a fit when
- The team tracks tasks in Jira or Linear.
- A web interface or a mobile app is required.
- The Bun runtime is unavailable.
Example request
Set up tuiboard from scratch: ask where to keep the boards, create one Markdown file per board plus the config, and leave the calendar alone.Limitations
Bun 1.2 or newer is required to run it, since the app does not run on Node. Google and Microsoft 365 calendars connect through the separate `tuiboard calendar-setup` command with a browser sign-in. OpenCode, Codex and Pi keep no record of running processes, so a session counts as busy while a turn updates and as stale after 30 minutes without changes. Exact states for every agent show when herdr is running.
How to disable. Remove the global `tuiboard` package with Bun and delete `~/.config/tuiboard/config.yaml`. Boards stay ordinary Markdown files and remain usable.
FAQ
Which agents does the session overview show?
Claude Code, Codex, OpenCode and Pi. No setup is needed, because data comes from each agent's local files.
What do the session state symbols mean?
The `×` sign means the agent waits for you, `◐` that it works, `✓` that the turn is done, `○` that the session is idle and `·` that it is closed. The `△` sign marks a turn that stopped updating.
How do I install `tuiboard` without npm?
Run `bun install -g github:NazzarenoGiannelli/tuiboard`. The npm variant is `bun install -g tuiboard`, and `bunx tuiboard` runs it once.
Can I turn off unused panels?
Yes. In the `zones:` block of the config set any zone to `off`, for example `agents: off` if you use no agents.
How do I add another board?
Create a new Markdown file with the `## To Do`, `## In Progress` and `## Done` column headings and add its absolute path to the `boards:` list in the config. The `Done` and `Archive` columns are hidden from the board.
Discussion
No questions or reviews yet.
Related
CLI toolsA local task board with the taskctl CLI and a skill for Codex, Claude Code, and other agents: creates issues, moves statuses, and keeps comments under a fixed w
A terminal kanban board in Python that Claude Code and other agents can read and change through a CLI or MCP
A skill sets up one shared task board for people and agents: kanban, a dependency graph and a code map on one page.
Signboard is a local Markdown-file kanban board with a built-in MCP server: the agent reads and moves cards on disk.
CodeKanban gathers terminals and Claude Code and Codex sessions on one page, and codekanban-cli drives them from an agent
kanban-md runs a file-based task board for agents and people: Markdown tasks, expiring claims and a terminal UI
README in short
The README shows all four zones with animations and explains the board format and config. A ready prompt lets an agent interview the user and create the files.