Docs / Guides / Dashboard

Web Dashboard

The Barrd dashboard gives you a visual interface to everything your AI assistants are doing. View tasks on a kanban board, review plans, browse decisions, and track sessions — all in real time.

Overview

The dashboard is the human side of Barrd. While Claude (or ChatGPT) interacts via MCP, you get a full web interface to see the same data. Everything syncs in real time — create a task from Claude Code and it appears on your board instantly.

Access the dashboard at your Barrd URL after logging in. The sidebar navigation gives you quick access to all sections.

Keyboard shortcuts: Press ? anywhere to see available keyboard shortcuts. Use G then T/S/P/D/E to jump between sections, or Cmd+K to search.

Tasks board

The tasks page is your project home — a kanban board with four columns:

  • To Do — Work that's queued up
  • In Progress — What's being worked on right now
  • Blocked — Tasks waiting on something (hidden when empty)
  • Done — Completed work, auto-collapsed when the list grows

Board & plan views

Toggle between Board view (status columns) and Plan view (tasks grouped by plan) using the view switcher in the toolbar.

Quick status changes

Click the status icon on any task card to change its status without opening the detail page. The dropdown shows all available transitions.

Filters

Filter tasks by status, priority, plan, or assignee using the filter button in the toolbar. Active filters are shown as chips that you can dismiss individually.

Real-time updates

The board updates in real time via server-sent events. When Claude creates or updates a task, you'll see the change immediately — no refresh needed. A green dot in the toolbar indicates the live connection is active.

Task detail page

Click any task card to open its detail page. From there you can edit the title, description, status, priority, assignee, and tags. The page also shows progress logs with file paths, so you can trace exactly what changed and where.

Plans

Plans group related tasks under a shared goal. The plans page shows all plans with status filter tabs (Draft, In Progress, Completed).

Plan detail

Click a plan to open its detail page. The two-column layout shows:

  • Main area — Editable Problem, Goal, and Approach fields (markdown supported), linked tasks with a progress bar, and content
  • Sidebar — Plan ID, status, priority, duration estimate, labels, linked documents, and dates

All fields are inline-editable — click to edit, Cmd+Enter to save, Esc to cancel.

Documents

Documents are long-form content — implementation plans, architecture notes, guides, retrospectives. The documents page uses a three-pane layout:

  • Sidebar — Searchable document list with create button
  • Editor — Rich markdown editor (TipTap) with toolbar and preview
  • Table of contents — Auto-generated from headings

Documents support types (guide, architecture, decision, implementation, etc.) and tags for organization.

Decisions

Every architectural or design decision gets its own record. The decisions page lists all decisions with status filter tabs:

  • Proposed — Under consideration
  • Accepted — Approved and active
  • Deprecated — No longer recommended
  • Superseded — Replaced by a newer decision

Click a decision to open its detail page where you can edit the title, description (markdown), status, and tags. Decisions are referenced automatically by Claude so past choices aren't relitigated.

Sessions

The sessions page shows all AI session snapshots for your project. Each session record captures:

  • Working memory — Current focus, phase, and next action
  • Context snapshot — Files modified, decisions made, tasks completed
  • Current task & plan — What was being worked on

Click a session row to expand its detail sidebar. The linked task and plan are prefetched so you can navigate directly to them.

This is read-only. Sessions are created and loaded by Claude automatically. The dashboard lets you review them, not edit them.

Themes

Barrd ships with two themes:

  • Midnight (dark) — Default. Designed for extended use.
  • Chalk (light) — For daylight or preference.

Toggle between themes using the sun/moon icon in the sidebar. Your preference is saved locally.

Mobile

The dashboard is fully responsive. On mobile:

  • The kanban board becomes a swipeable column view with tab navigation
  • Filters open as a bottom sheet
  • The sidebar collapses into a mobile nav
  • All touch targets are sized for comfortable tapping (44px minimum)

Next steps