dashboard-builder

---

version: "3.3.0"

name: Dashboard Builder

description: "Build and render ASCII dashboards in terminal with bar charts, gauges, tables, and text panels. Use when visualizing metrics or monitoring data."

author: BytesAgain

homepage: https://bytesagain.com

source: https://github.com/bytesagain/ai-skills

tags: [dashboard, terminal, ascii, chart, monitoring]

category: "devtools"

---

# dashboard-builder

Terminal dashboard toolkit — create dashboards with bar charts, gauges, tables, and text panels, all rendered as ASCII art in your terminal.

Commands

`create`

Create a new dashboard configuration.

scripts/script.sh create server-metrics

`add-widget`

Add a widget to a dashboard. Types: bar, gauge, table, text.

scripts/script.sh add-widget server-metrics bar "Revenue:85,Costs:42,Profit:43"
scripts/script.sh add-widget server-metrics gauge "CPU:72:100"
scripts/script.sh add-widget server-metrics table "Service:Status|API:OK|DB:OK"
scripts/script.sh add-widget server-metrics text "All systems operational"

`render`

Render a dashboard in the terminal with ASCII art charts.

scripts/script.sh render server-metrics

Output includes bordered frames, bar charts with `█░` characters, gauges with percentage and threshold labels, and formatted tables.

`list`

List all dashboards with widget counts and sizes.

scripts/script.sh list

`show`

Show the raw JSON configuration of a dashboard.

scripts/script.sh show server-metrics

`delete`

Delete a dashboard.

scripts/script.sh delete old-dashboard

`export`

Export a dashboard to JSON, plain text, or HTML.

scripts/script.sh export server-metrics json
scripts/script.sh export server-metrics html
scripts/script.sh export server-metrics txt

`import`

Import a dashboard from a JSON file.

scripts/script.sh import backup.json

`demo`

Show a built-in demo dashboard with all widget types rendered.

scripts/script.sh demo

Examples

# Full workflow
scripts/script.sh create sales-q4
scripts/script.sh add-widget sales-q4 bar "Jan:120,Feb:95,Mar:140,Apr:180"
scripts/script.sh add-widget sales-q4 gauge "Target:340:500"
scripts/script.sh add-widget sales-q4 table "Region:Revenue:Growth|US:2.4M:12%|EU:1.8M:8%|APAC:900K:22%"
scripts/script.sh add-widget sales-q4 text "Q4 revenue on track"
scripts/script.sh render sales-q4
scripts/script.sh export sales-q4 html

Configuration

| Variable | Required | Description |

|----------|----------|-------------|

| `DASHBOARD_BUILDER_DIR` | No | Data directory (default: `~/.dashboard-builder/`) |

Data Storage

All dashboards saved in `~/.dashboard-builder/dashboards/` as JSON files.

Each dashboard file contains:

Widget data format:

Requirements

---

*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*