shipitagent

Tools · Documents and apps

render_dashboard

Can wait for approval

Render a rich HTML dashboard (metrics, timeline, bars, cards, phases, chart, verdict) from a structured spec.

When to use: Use when the user asks for a visual dashboard, one-pager, life vision, finance breakdown, or any structured answer that benefits from cards + charts instead of paragraphs of prose.

Example

Run for real by scripts/tool-examples.py in a small demo project, with Haiku 5.5 where the tool calls a model. The output is exactly what the tool returned.

What it rendered

rendered output

The call

tool call
{
  "tool": "render_dashboard",
  "arguments": {
    "title": "Revenue · Q3",
    "subtitle": "From data/orders.csv and the billing export",
    "sections": [
      {
        "type": "metrics",
        "title": "This quarter",
        "columns": 3,
        "items": [
          {
            "label": "MRR",
            "value": "$48.2k",
            "delta": "+12% QoQ"
          },
          {
            "label": "New accounts",
            "value": "214",
            "delta": "+31"
          },
          {
            "label": "Churn",
            "value": "1.8%",
            "delta": "-0.4 pts"
          }
        ]
      },
      {
        "type": "line_chart",
        "title": "MRR by month (k$)",
        "labels": [
          "Apr",
          "May",
          "Jun",
          "Jul",
          "Aug",
          "Sep"
        ],
        "values": [
          36.1,
          38.4,
          40.2,
          43,
          45.9,
          48.2
        ]
      },
      {
        "type": "verdict",
        "title": "Takeaway",
        "text": "Growth is steady; **EMEA** drove most of it. Focus Q4 on APAC."
      }
    ]
  }
}

Real output

Dashboard rendered: revenue-q3.html (3 sections, 6,013 chars).

Parameters

NameTypeDescription
title*stringTop-level dashboard heading.
subtitlestringSmaller caption under the title (context, date).
langstringBCP-47 language tag for the <html> element. Use 'hi' for Hindi-mixed content, 'en' otherwise.
sections*arrayOrdered dashboard sections. Each item must have a 'type' key — see the prompt for supported types (metrics, line_chart, bar_chart, bars, timeline, cards, lifestyle_grid, phases, callout, verdict).
exportbooleanIf true, also write the HTML to disk.
pathstringOptional export filename or relative path. Defaults to a slug of 'title'.
namestringOptional artifact name override.

* required

Build documents, dashboards and small apps people can open.