bootspring_dashboard
Get dashboard status, start the dashboard server, or get the URL.
Overview#
The bootspring_dashboard tool manages the Bootspring real-time dashboard. The dashboard provides a visual interface for monitoring project status, viewing todo lists, tracking workflows, and more.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | No | Action to perform (default: status) |
Actions#
| Action | Description |
|---|---|
status | Check if dashboard is running |
url | Get the dashboard URL |
start | Start the dashboard server |
stop | Stop the dashboard server |
Usage Examples#
Check Status#
Use the bootspring_dashboard tool with:
- action: "status"
Response (running):
Response (stopped):
Get URL#
Use the bootspring_dashboard tool with:
- action: "url"
Response:
http://localhost:3456
Start Dashboard#
Use the bootspring_dashboard tool with:
- action: "start"
Response (success):
Response (already running):
Response (failed):
Stop Dashboard#
Use the bootspring_dashboard tool with:
- action: "stop"
Response (success):
Response (not running):
Configuration#
Configure the dashboard port in bootspring.config.js:
Dashboard Features#
The real-time dashboard provides:
Project Overview#
- Project health status
- Current development phase
- Open issues count
Todo Management#
- View pending and completed todos
- Mark items complete
- Add new tasks
Workflow Tracking#
- Active workflow progress
- Step-by-step guidance
- Checkpoint status
Agent Activity#
- Recent agent invocations
- Suggested agents
- Agent response history
Quality Metrics#
- Lint status
- Test coverage
- Type errors
CLI Integration#
The dashboard can also be started via CLI:
Technical Details#
Process Management#
- Dashboard runs as a detached process
- Survives terminal closure
- Uses
unref()for independent lifecycle
Port Detection#
- Checks if port is already in use
- HTTP health check for status detection
- 1 second timeout for port checks
Startup Sequence#
- Check if already running
- Spawn Node.js process
- Wait 1 second for startup
- Verify server is responding
Error Handling#
Port in Use#
If the port is already in use by another application:
Solution: Change the port in configuration or stop the conflicting process.
Permission Denied#
If the port requires elevated permissions (ports < 1024):
Solution: Use a port above 1024 or run with elevated permissions.
Best Practices#
Keep Dashboard Running#
Start the dashboard at the beginning of your development session for real-time monitoring.
Use Status Checks#
Before starting, check status to avoid duplicate processes.
Configure Port#
If port 3456 conflicts with other services, configure a different port.
Related Tools#
- bootspring_todo - Manage todos shown in dashboard
- bootspring_workflow - Workflows tracked in dashboard
- bootspring_quality - Quality metrics in dashboard