Hermes TaskBoard — Fleet Kanban Command

The Hermes fleet kanban hub — Fleet Command rollup, per-profile boards, DRAVEN service bar, and global MCP for Cursor agents.
Fork of TaskBoardAI, customized for the JonBeatz / Hermes multi-profile workspace.

---

Single source of truth: Read TRUTH.md first, then AGENTS.md and the fleet runbook at D:\Hermes\projects\_core-scripts\shared-profile-content\docs\KANBAN-WORKFLOW.md.

Current Status

Metric	Value
Version	v1.0.0 (Latest release)
Stack	Node.js · Express · file-based JSON boards · MCP (stdio)
Fleet Command	http://localhost:3001/ — read-only rollup across all profile boards
Profile board	http://localhost:3001/?board=<boardId> — e.g. next-flick, jonbeatz
MCP	Global in %USERPROFILE%\.cursor\mcp.json — taskboard server
Board data	boards/{boardId}.json — local fleet data (gitignored; backup separately)
Status	Production-ready for Hermes fleet local use

---

Screenshots

Fleet Command (default home)

Read-only rollup at / — project cards, NEXT STEPS inbox, DRAVEN footer with LiteLLM / LM Studio / Profile Jedi probes.

Profile board (Next-Flick example)

Per-profile kanban at /?board=next-flick — To Do / In Progress / Blocked / Done, agent activity feed, SYSTEM monitor.

Fleet Health modal

DRAVEN health-check dialog — core services, LiteLLM model list, Profile Jedi online status.

---

Why Hermes TaskBoard?

Upstream TaskBoardAI is a great file-based kanban + MCP tool. Hermes TaskBoard extends it for multi-profile fleet ops:

Capability	Hermes TaskBoard	Upstream TaskBoardAI
Fleet Command rollup at /	Yes	No
DRAVEN footer + service probes	Yes	No
Profile Jedi deep-links (?board=)	Yes	No
Fleet Health modal (LiteLLM models)	Yes	No
Attention inbox + Import/Archive	Yes	Partial
Global MCP for all Hermes profiles	Yes	Yes
File-based JSON boards	Yes	Yes

Upstream credit: TuckerTucker/TaskBoardAI (Apache-2.0). We merge selectively via upstream remote — never push to TuckerTucker.

---

Quick Start

Prerequisites

• Node.js 20+
• Windows 10/11 (Hermes fleet scripts are PowerShell)
• Hermes profile registry at D:\Hermes\projects\_core-scripts\profile-switcher\profiles.json

Install & run (from clone)

git clone https://github.com/jonbeatz/hermes-taskboard.git
cd hermes-taskboard
npm install
npm run start:all    # HTTP :3001 + MCP stdio

Open http://localhost:3001/ (Fleet Command) or http://localhost:3001/?board=next-flick.

Fleet stack (recommended)

From JonBeatz hub:

cd D:\Hermes\projects\JonBeatz
npm run kanban:start   # TaskBoard :3001 + Hermes Workspace :3005 + Dashboard :9119

Or use Profile Jedi Extras (http://localhost:7780) — auto-starts kanban if :3001 is down.

Backup (includes board JSON)

cd D:\Hermes\apps\TaskBoardAI
npm run backup:quick   # → G:\Hermes_Project_BackUpz\apps\TaskBoardAI\

---

Architecture

Hermes TaskBoard (:3001)
├── Express API          server/server.js
├── Fleet services       server/fleet/*  — overview, health, Profile Jedi start
├── Manager UI           app/            — Fleet Command + per-board kanban
├── MCP (stdio)          server/mcp/kanbanMcpServer.js  → global Cursor mcp.json
└── Board JSON           boards/{boardId}.json  (local, gitignored)

Agent rule: When Jon asks to add/update kanban tasks, use TaskBoard MCP with the active workspace's boardId. Do not duplicate MCP in project .cursor/mcp.json.

---

Core Features (v1.0.0)

• Fleet Command — rollup of all profile boards without ?board=
• Per-profile boards — one JSON file per Hermes profile (next-flick, jonbeatz, …)
• DRAVEN footer — Hermes, LM Studio, Dashboard, LiteLLM, ComfyUI capsules + Fleet Health
• Agent activity feed — live task create/update/delete trail
• MCP tools — create/update/move cards from Cursor agents
• Import / Archive — board lifecycle from header controls
• Profile Jedi integration — Extras menu deep-links + smart start

---

Ports

Port	Service
3001	Hermes TaskBoard (this app)
3005	Hermes Workspace (visual kanban UI)
7780	Profile Jedi
9119	Hermes Dashboard
4000	LiteLLM
1234	LM Studio

---

Documentation

Document	Purpose
TRUTH.md	Project constitution
AGENTS.md	Agent cold-start
GITHUB-SETUP.md	Branch model, remotes, release
CHANGELOG.md	Version history
KANBAN-WORKFLOW.md	Fleet kanban runbook (hermes-core-scripts)

---

Related repos

Repo	Role
jonbeatz/hermes-core-scripts	Kanban stack launcher, profiles.json, fleet docs
jonbeatz/profile-jedi	Profile switcher + Extras deep-links
TuckerTucker/TaskBoardAI	Upstream (read-only)

---

License

Apache-2.0 — see LICENSE. Hermes fleet customizations © Jon Beatz. Upstream © TuckerTucker.

---

Hermes fleet · local-first · boards stay on your machine