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

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 (Agents)

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

Navigate to Agents 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

Mind

Homepage — health, blockers, stale work, next actions (also reachable as Dashboard)

Board

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

Specs

Specifications with requirements, status tracking, coverage

Sprints

Start/end sprints, see sprint progress

Code

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

Agents

Agent registry, task queue, run orchestration cycles (route: agents/orchestrate)

Memory

Cross-session knowledge base, project facts

Skills

BMAD skills versioned in repo (mvp/planning/scrum-master/test)

Docs

Bundled markdown docs served from /api/docs

Calendar

Cards organized by due date

Reports

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

Timeline

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

Activity

Combined timeline of history entries and agent sessions

Settings

Board config, columns, theme

AI Agent

Copy-paste MCP setup prompt for Claude/OpenCode/Cursor

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 [--port 4321] [--token mysecret]
$ barkcli serve --status
$ barkcli serve --stop [--port 4321]
$ barkcli serve --kill [--port 4321]

The daemon writes its PID to .board/server.pid (port/host in .board/server.json) and watches board files for live WebSocket reload. Default port is 4321. With --token, pass ?token= or Authorization: Bearer on /api/* and /ws.

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 Mind tab — quick overview of project health
← Back to Docs