Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix Proposal: Add kanban-artifacts to official dashboard plugin registry [1 pull requests]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Fix Action

Fixed

Code Example

{
  "name": "kanban-artifacts",
  "label": "Kanban Artifacts",
  "description": "Browse and preview output files from Hermes Kanban task workspaces",
  "icon": "FolderOpen",
  "version": "1.0.0",
  "tab": {
    "path": "/kanban-artifacts",
    "position": "after:kanban"
  },
  "entry": "dist/index.js",
  "css": "dist/style.css",
  "api": "plugin_api.py"
}
RAW_BUFFERClick to expand / collapse

Proposal: kanban-artifacts Dashboard Plugin for Official Registry

Plugin name: kanban-artifacts Type: Dashboard plugin (web tab + FastAPI backend — not an agent tool plugin) Repository: User-installed at ~/.hermes/plugins/kanban-artifacts/dashboard/

What the plugin does

kanban-artifacts adds a Kanban Artifacts tab to the Hermes dashboard (positioned after the built-in Kanban tab). It lets users:

  • Browse task artifacts (generated files) organized by board and task within ~/.hermes/kanban/workspaces/
  • Preview common file types inline (images, markdown, code, PDFs, audio/video)
  • Download raw files (with streaming, size-capped at 50 MB)
  • Navigate workspaces with path-traversal protection (only ~/.hermes/kanban/workspaces/ and ~/.hermes/kanban/boards/ are accessible)

Backend API routes (FastAPI via plugin_api.py)

MethodRouteDescription
GET/api/plugins/kanban-artifacts/boardsList all Kanban boards (from SQLite)
GET/api/plugins/kanban-artifacts/tasksList all tasks across boards
GET/api/plugins/kanban-artifacts/filesBrowse artifact files in a workspace
GET/api/plugins/kanban-artifacts/rawStream raw file content (size-capped)
GET/api/plugins/kanban-artifacts/metadataServe file/folder metadata

Frontend (index.js)

  • React component using window.__HERMES_PLUGIN_SDK__ (shadcn-based components)
  • Registers via window.__HERMES_PLUGINS__.register('kanban-artifacts', Component)
  • Markdown preview with HTML sanitization
  • Audio/video playback for media files
  • Image gallery for visual artifacts

Security model

  • Session token auth via X-Hermes-Session-Token header (SDK standard)
  • Path traversal blocked by Path.resolve() + allowlist check
  • Streaming responses with hard 50 MB cap on /raw
  • SQL injection protected via parameterized queries
  • XSS blocked by HTML-escaping markdown before render
  • Header injection mitigated by quoting download filenames

manifest.json

{
  "name": "kanban-artifacts",
  "label": "Kanban Artifacts",
  "description": "Browse and preview output files from Hermes Kanban task workspaces",
  "icon": "FolderOpen",
  "version": "1.0.0",
  "tab": {
    "path": "/kanban-artifacts",
    "position": "after:kanban"
  },
  "entry": "dist/index.js",
  "css": "dist/style.css",
  "api": "plugin_api.py"
}

Motivation

The Hermes Kanban board (hermes kanban / hbk) runs agentic tasks and produces rich output artifacts (code, reports, images, logs) — but these are only accessible via the filesystem. A dashboard tab makes them easy to browse, preview, and share — which significantly improves the UX for users who prefer the web UI over the terminal.

Files

PathRole
~/.hermes/plugins/kanban-artifacts/dashboard/manifest.jsonDashboard plugin manifest
~/.hermes/plugins/kanban-artifacts/dashboard/plugin_api.pyFastAPI backend (list boards/tasks/files, serve raw)
~/.hermes/plugins/kanban-artifacts/dashboard/index.jsReact frontend component
~/.hermes/plugins/kanban-artifacts/dashboard/dist/index.jsBuilt JS bundle
~/.hermes/plugins/kanban-artifacts/dashboard/dist/style.cssCSS

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix Proposal: Add kanban-artifacts to official dashboard plugin registry [1 pull requests]