@dendroman/sidecar-dashboard

Sidecar Dashboard - Web dashboard for agentic project tracking.

A Kanban-style dashboard for visualizing Sidecar project data including tasks, agents, and activity feeds.

Installation

npm install @dendroman/sidecar-dashboard

Usage

Development

npm run dev

Build

# Build for production (Next.js standalone)
npm run build

# Build static export
EXPORT_STATIC=true npm run build

Environment Variables

| Variable | Description | |----------|-------------| | SIDECAR_REPO_PATH | Path to the Sidecar repository to display | | PORT | Port for the development server (default: 3000) | | EXPORT_STATIC | Set to true for static export build |

With the CLI

The dashboard is typically launched via the Sidecar CLI:

sidecar dashboard

This automatically sets the SIDECAR_REPO_PATH environment variable.

Standalone Usage

You can also run the dashboard directly:

SIDECAR_REPO_PATH=/path/to/repo npm run dev

Features

• Kanban Board: Drag-and-drop task management across swimlanes
• Agent Activity Feed: Real-time view of agent status and activity
• Responsive Design: Works on desktop and mobile
• Auto-refresh: Polls for updates every 5 seconds
• Dark Mode: Built-in dark theme support

API Routes

• GET /api/sidecar?file=backlog - Get backlog data
• GET /api/sidecar?file=agents - Get agent data
• POST /api/sidecar?file=backlog - Update task status

License

ISC