Dashboard Commands
Start and manage the Bootspring real-time dashboard.
Synopsis#
bootspring dashboard [options]Description#
The dashboard provides a visual interface for monitoring your project, viewing todos, tracking workflows, and more.
Options#
| Option | Description |
|---|---|
--port <port> | Custom port (default: 3456) |
--open | Open in browser automatically |
--stop | Stop the dashboard |
--status | Check dashboard status |
Usage#
Start Dashboard#
bootspring dashboardOutput:
Starting Bootspring Dashboard...
Dashboard running at: http://localhost:3456
Press Ctrl+C to stop
Start on Custom Port#
bootspring dashboard --port 4000Start and Open Browser#
bootspring dashboard --openCheck Status#
bootspring dashboard --statusOutput (running):
Dashboard Status
═══════════════════════════════════════════════════════════════════
Status: Running
URL: http://localhost:3456
PID: 12345
Stop with: bootspring dashboard --stop
Output (stopped):
Dashboard Status
═══════════════════════════════════════════════════════════════════
Status: Stopped
Start with: bootspring dashboard
Stop Dashboard#
bootspring dashboard --stopOutput:
Dashboard stopped
Dashboard Features#
Project Overview#
┌─────────────────────────────────────────────────────────────────┐
│ Project: my-awesome-app │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Health: Good ● Phase: Development │
│ Stack: Next.js 14 Database: PostgreSQL │
│ │
│ Open Todos: 3 Active Workflow: feature-development │
│ Last Updated: 5m ago Bootspring: v1.2.3 │
│ │
└─────────────────────────────────────────────────────────────────┘
Todo List#
View and manage todos:
- See pending and completed tasks
- Mark items complete
- Add new tasks
- Clear completed items
Workflow Progress#
Track active workflows:
- Current phase status
- Progress percentage
- Phase history
- Artifacts generated
Agent Activity#
Monitor agent usage:
- Recent agent invocations
- Suggested agents for current context
- Agent response history
Quality Metrics#
Code quality at a glance:
- Lint status
- Test coverage
- Type errors
- Security issues
Configuration#
Dashboard Settings#
1// bootspring.config.js
2module.exports = {
3 dashboard: {
4 port: 3456, // Default port
5 autoOpen: false, // Open browser on start
6 refreshInterval: 5000, // Update interval in ms
7 },
8};Running in Background#
The dashboard runs as a detached process:
1# Start in background
2bootspring dashboard &
3
4# Or use nohup
5nohup bootspring dashboard > /dev/null 2>&1 &
6
7# Check if running
8bootspring dashboard --status
9
10# Stop when done
11bootspring dashboard --stopTroubleshooting#
Port Already in Use#
Error: Port 3456 is already in use
Solutions:
- Use a different port:
bootspring dashboard --port 4000 - Stop existing process:
bootspring dashboard --stop - Find and kill the process:
lsof -i :3456
Dashboard Not Loading#
- Check status:
bootspring dashboard --status - Restart:
bootspring dashboard --stop && bootspring dashboard - Check logs in
.bootspring/dashboard.log
Cannot Connect#
- Verify URL:
http://localhost:3456 - Check firewall settings
- Try different browser
Related#
- bootspring_dashboard - MCP tool reference
- Dashboard Tour - Visual guide
- Todo Commands - CLI task management