hermes - 💡(How to fix) Fix Kanban dashboard should support task/card deep links

Official PRs (…)
ON THIS PAGE

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…

Code Example

/kanban?board=<slug>&task=<task_id>
RAW_BUFFERClick to expand / collapse

Feature Description

The Kanban dashboard currently supports a top-level /kanban route, but it does not appear to support durable deep links to a specific board/task/card. This makes it hard to point users and agents at the actionable source of truth.

Motivation

Hermes agents should treat the Kanban board as the operational work queue: tasks, comments, status, handoffs, run history, and blockers should live there. In practice, when there is no direct card URL to cite or reopen, agents drift toward writing scattered .md status files and handoff notes around the filesystem. That makes work harder to find, review, resume, and route.

A task/card deep link would give agents and humans a canonical target for follow-ups, review requests, completion evidence, blocked-state discussions, and dashboard notifications.

Current Behavior

  • /kanban opens the Kanban dashboard tab.
  • Board selection is stored in browser localStorage (hermes.kanban.selectedBoard).
  • The selected task drawer/card is React state only (selectedTaskId).
  • There is no obvious support for URLs such as:
    • /kanban?board=<slug>&task=<task_id>
    • /kanban/<task_id>
    • /kanban/<board>/<task_id>

Proposed Solution

Add canonical Kanban dashboard deep links, preferably query based for backward compatibility:

/kanban?board=<slug>&task=<task_id>

Recommended behavior:

  1. On load, parse board and task query params.
  2. If board is present, select that board and persist it to the dashboard's selected-board storage.
  3. If task is present, open the task drawer once board data is loaded.
  4. When a task drawer opens from click/navigation, update the URL with task=<id> without a full reload.
  5. When the drawer closes, remove task from the URL while preserving board and other filters.
  6. If the task is not found in the current filters, show a clear message and/or load it directly from the task detail API.
  7. Expose/copy the canonical link from the task drawer.
  8. Use these links in dashboard notifications, Kanban comments, and any human-facing “review required” messages where appropriate.

Acceptance Criteria

  • Visiting /kanban?board=default&task=t_xxx opens the Kanban tab, selects the default board, and opens task t_xxx in the drawer.
  • Visiting /kanban?board=<other>&task=t_xxx selects the named board and opens the task there.
  • Opening a task card updates the browser URL to include task=<id>.
  • Closing the drawer removes task=<id> from the URL.
  • The task drawer has a visible “Copy link” action.
  • Deep links survive page refresh.
  • Existing /kanban behavior and localStorage board persistence remain compatible.
  • Tests cover URL parsing, task drawer open/close URL synchronization, and unknown task handling.

Alternatives Considered

  • Continue using ad hoc .md files for handoffs/status: poor discoverability and not actionable.
  • Switch back to Todoist for task links: workable, but duplicates the Hermes-native Kanban system instead of improving it.

Related Areas

  • plugins/kanban/dashboard/dist/index.js / dashboard frontend source, if available
  • plugins/kanban/dashboard/plugin_api.py
  • dashboard plugin route registration for /kanban
  • Kanban notifier/comment/review-required surfaces that could emit canonical dashboard URLs

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