A fresh, production-ready dashboard for Coven agents, built with Next.js 14, TypeScript, React, and Tailwind CSS. Real data from the Coven gateway, zero mock data.
- ✨ Live agent status grid — See all agents at a glance
- 📊 Quick stats — Active sessions, tasks in flight, completed tasks, blocked items
- 🟢 System health monitoring — Gateway, memory layer, plugins status
- 🔄 Auto-reconnect — WebSocket connection with exponential backoff
- 📱 Responsive design — Desktop, tablet, phone optimized
- ♿ Accessible — WCAG AA compliant
- Framework: Next.js 14
- Language: TypeScript
- Styling: Tailwind CSS
- UI: React with Lucide icons
- Deployment: Vercel
- Package:
@opencoven/dash(npm)
- Node.js 18+ (tested with v24.13.0)
- npm or yarn
- Clone the repository:
cd ~/Documents/GitHub/OpenCoven/coven-dash- Install dependencies:
npm install- Configure environment variables:
cp .env.example .env.local
# Edit .env.local with your gateway details- Start development server:
npm run dev- Open http://localhost:3000 in your browser
GATEWAY_URL=wss://your-gateway-url.com
GATEWAY_TOKEN=your-secure-token
GATEWAY_PASSWORD=optional-password
- Dashboard Home (
/dashboard) — Agent status grid, quick stats, system health, quick actions - Sessions Browser (coming in next step) — Live session list, filters, quick actions
- Tasks & Delegation (coming in next step) — Task board with drag-drop delegation
- Cross-Project Dashboard (coming in next step) — Projects, stats, agent utilization
- Server-side connection to Coven gateway
- Auto-reconnect with exponential backoff (max 30s delay)
- Health monitoring and caching
- Event-based data updates
- Provides cached dashboard data to frontend
- Handles gateway initialization
- Graceful error handling
QuickStats— Overview metricsSystemHealthCard— Health status indicatorsAgentGrid— Agent cards with status and quick actions
npm run buildnpm run lintnpm run format- Push to GitHub
- Import repository in Vercel
- Add environment variables
- Deploy (auto on push)
docker build -t coven-dash .
docker run -p 3000:3000 -e GATEWAY_URL=... coven-dash- ✅ Set up Next.js repo structure
- ✅ Implement gateway WebSocket client (server-side)
- ✅ Build Dashboard Home page
- ⬜ Add Sessions Browser page
- ⬜ Add Tasks & Delegation page
- ⬜ Add Cross-Project page
- ⬜ Test with real gateway
- ⬜ Deploy to Vercel
- ✅ Zero mock data (all live from gateway)
- ⬜ Connection stays alive (auto-reconnect working)
- ✅ Dashboard Home page functional
- ⬜ All 4 pages functional
- ⬜ Productivity metrics accurate
- ⬜ Deployed to Vercel
- ⬜ Multi-user ready
See AGENTS.md for contribution guidelines.
Proprietary. For OpenCoven team only.
Built with ✨ for Coven