Dashboard Commands
Start and manage the Bootspring real-time dashboard.
Synopsis#
Loading code block...
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#
Loading code block...
Output:
Starting Bootspring Dashboard...
Dashboard running at: http://localhost:3456
Press Ctrl+C to stop
Start on Custom Port#
Loading code block...
Start and Open Browser#
Loading code block...
Check Status#
Loading code block...
Output (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#
Loading code block...
Output:
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#
Loading code block...
Running in Background#
The dashboard runs as a detached process:
Loading code block...
Troubleshooting#
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