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