Web App Guide

The web app provides a full-featured browser interface for managing your boards. No CLI knowledge required.

Quick Start

Start the web app with a single command:

$ barkcli serve --open

The app opens at http://localhost:4321. If no .board/ directory exists, barkcli automatically creates one with a default board.

Features

Board Management

Kanban board with drag-and-drop, table view, and list view. Add, edit, move, and delete cards.

barkcli serve --open

Memory System

Cross-session knowledge base with 4 tiers (working, short-term, long-term, external) and BM25 search.

Navigate to Memory tab

Specs & Requirements

Manage specifications with requirements, status tracking, coverage reports, and traceability.

Navigate to Specs tab

Orchestration

Agent registry, task queue, and orchestration cycles for AI-powered task management.

Navigate to Orchestrate tab

Timeline & Tools

Checkpoints, undo, snapshots, blame, diff, validate/doctor, and import/export.

Navigate to Timeline tab

Real-time Updates

WebSocket-based live reload. All changes reflected instantly across browser tabs.

Automatic on all changes

Navigation Tabs

Dashboard

Overview with stats, sprint progress, recent activity, due-soon cards

Board

Kanban board with drag-and-drop (switch between board/table/list views)

Calendar

Cards organized by due date

Reports

Effort by column/area, priority breakdown, sprint burndown charts

Code

Search code symbols, see which cards are linked to which files

Activity

Combined timeline of history entries and agent sessions

Sprints

Start/end sprints, see sprint progress

Memory

Cross-session knowledge base, project facts

Specs

Specifications with requirements, status tracking, coverage

Orchestrate

Agent registry, task queue, run orchestration cycles

Timeline

Checkpoints, undo, diff, blame, validate/doctor, import/export

Settings

Board config, columns, theme

Keyboard Shortcuts

Command paletteCmd/Ctrl + K
Undo last changeCmd/Ctrl + Z
New card (on Board view)N
Show keyboard shortcuts?

Background Mode

Run the web app as a background daemon:

$ barkcli serve --daemon
$ barkcli serve --status
$ barkcli serve --stop

The daemon writes its PID to .board/server.pid and watches for file changes.

Board Management

View Modes

Switch between three views on the Board tab:

  • •Board — Classic kanban columns with drag-and-drop
  • •Table — Spreadsheet-like view with sortable columns
  • •List — Compact list sorted by priority

Card Operations

  • •Add — Click + on column header, press N, or use Cmd+K
  • •Edit — Click any card to open edit form
  • •Move — Drag card to another column
  • •Delete — Delete from card form (with undo toast)

Tips

  • 1.Use keyboard shortcuts — they're faster than clicking
  • 2.Pin important cards — they stay at the top of columns
  • 3.Add labels — filter cards by label in the board view
  • 4.Set due dates — see cards on the Calendar tab
  • 5.Use specs — track requirements alongside cards
  • 6.Save checkpoints — before major changes
  • 7.Check the Dashboard — quick overview of project health
← Back to Docs