Skip to content

feat(kanban-artifacts): add dashboard plugin for browsing kanban task artifacts#4

Open
vivekshetye wants to merge 1 commit into
NousResearch:mainfrom
vivekshetye:feat/add-kanban-artifacts-plugin
Open

feat(kanban-artifacts): add dashboard plugin for browsing kanban task artifacts#4
vivekshetye wants to merge 1 commit into
NousResearch:mainfrom
vivekshetye:feat/add-kanban-artifacts-plugin

Conversation

@vivekshetye
Copy link
Copy Markdown

@vivekshetye vivekshetye commented May 26, 2026

Summary

Adds kanban-artifacts as a reference implementation for a Hermes dashboard plugin. It adds a tab to the Hermes dashboard (after the built-in Kanban tab) that lets users browse, preview, and download files from task workspaces.

Features

  • Dashboard plugin with 3-column layout: boards sidebar, file list, file preview
  • Browse kanban task workspaces with file content preview (markdown, code, images)
  • Per-board task caching to prevent cross-board task contamination when multiple boards are expanded simultaneously
  • Support for the default board (root kanban.db) alongside per-board databases in boards/ subdirectory
  • Simplified Bearer token auth compatible with Hermes dashboard session tokens
  • API endpoints: /boards, /boards/<slug>/tasks, /tasks/<id>/files, /files

Bug Fixes

  • Cross-board task contamination: Fixed a bug where expanding one board's tasks would cause other expanded boards to show the same tasks. Added per-board tasksCache state so each board's tasks are cached independently.

Security

  • Session token auth on all API routes
  • Path traversal protection (allowlist-based)
  • SQL injection protection (parameterized queries)
  • XSS protection (HTML-escaping for markdown)
  • Size cap on raw file serving (50 MB)

Files

  • kanban-artifacts/dashboard/index.js — React component (source)
  • kanban-artifacts/dashboard/dist/index.js — Minified bundle (served to browser)
  • kanban-artifacts/dashboard/plugin_api.py — FastAPI plugin routes
  • kanban-artifacts/dashboard/manifest.json — Plugin manifest
  • kanban-artifacts/dashboard/dist/style.css — Styles
  • kanban-artifacts/README.md — Documentation

Installation

Copy kanban-artifacts/ to ~/.hermes/plugins/ — the dashboard auto-discovers it on next startup.

- Dashboard plugin with 3-column layout: boards sidebar, file list, file preview
- Browse kanban task workspaces with file content preview (markdown, code, images)
- Per-board task caching to prevent cross-board contamination when multiple
  boards are expanded simultaneously
- Support for the 'default' board (root kanban.db) alongside per-board databases
- Simplified Bearer token auth compatible with Hermes dashboard session tokens
- API endpoints: /boards, /boards/<slug>/tasks, /tasks/<id>/files, /files
- Features: search/filter tasks, column resizing, file download, workspace browsing
@vivekshetye vivekshetye force-pushed the feat/add-kanban-artifacts-plugin branch from 96775d4 to 6d0cae5 Compare May 26, 2026 08:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant