Skip to content
DocsChartsRuns with brushLast updated Nov 2, 2026

Runs with brush

A week of runs, with the moment that matters in focus. Sample data: agent runs and success rate, Oct 10 to Oct 16, 96.2% today, one deploy and one incident marked.

Hourly runs and success rate20,267 runs over 7 days (OCT 10 to OCT 16), 2,910 of them today; the success rate dips to 93.89% at the incident, after deploy #2041.DEPLOY #2041INCIDENTOCT 10OCT 12OCT 13OCT 14OCT 15OCT 1696.2% TODAYRUNSRUNS TODAYSUCCESS RATELAST WEEK
Hourly runs and success rate
DayRunsAverage success rate
OCT 10295298.10%
OCT 11293997.05%
OCT 12286097.66%
OCT 13283697.59%
OCT 14283997.11%
OCT 15293198.05%
OCT 16291096.20%
Hourly runs and success rate20,267 runs over 7 days (OCT 10 to OCT 16), 2,910 of them today; the success rate dips to 93.89% at the incident, after deploy #2041.DEPLOY #2041INCIDENTOCT 10OCT 12OCT 14OCT 1696.2% TODAYRUNSRUNS TODAYSUCCESS RATELAST WEEK
Hourly runs and success rate
DayRunsAverage success rate
OCT 10295298.10%
OCT 11293997.05%
OCT 12286097.66%
OCT 13283697.59%
OCT 14283997.11%
OCT 15293198.05%
OCT 16291096.20%

Installation

  1. 1

    Set up the registry once

    Your token in .env and @chartory in components.json. Skip this when another chart is already installed.

    Installation guide
  2. 2

    Add the chart

    One command adds the Runs with brush component to your project.

    npx shadcn add @chartory/runs-with-brush
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { RunsWithBrush }  from "@/components/chartory/runs-with-brush"<RunsWithBrush  data={agentRuns}  size="m"  legend/>

Props

<RunsWithBrush>

Every prop but data is a Figma property with the same name and values.

PropTypeDefault
data: The chart's data. The tables below list every field.RunsWithBrushDataRequired
size: The size class. Each one is laid out again from the data."xs" | "s" | "m" | "l""m"
legend: Shows the legend row under the plot.booleantrue
color: The data colour of the primary marks (data/primary)."cat-1" | "cat-2" | "cat-3" | "cat-4""cat-1"

RunsWithBrushData

The data prop: one object for the whole chart.

PropTypeDefault
runs: The runs, per point.number[]Required
rate: The rate, per point.number[]Required
ghost: The earlier value, drawn as a ghost.number[]Required
rmin: The bottom of the rate scale.numberRequired
rmax: The top of the rate scale.numberRequired
days: The days.string[]Required
events: One entry per event.RunsWithBrushEvent[]Required
tip?: The text of the highlighted point's chip.string—

RunsWithBrushEvent

One object per entry in events.

PropTypeDefault
h: The hour of the event.numberRequired
text: The label as shown.stringRequired
tone: The tone of the mark (a colour token)."success" | "warning" | "danger" | "info" | "neutral" | "primary"Required

The data as a JSON Schema: schemas/runs-with-brush.json

Runs with brush chart: a React and Figma chart in four sizes

What does a runs with brush chart show?

A runs with brush chart shows run counts and success rate over a week, with a brush outline on today and markers for deploys and incidents. You see the day against the whole week on one card. Use it for agent runs, jobs and pipelines.

Chartory ships it as a Figma component and a React component with the same name. The code installs from the shadcn registry with one command and lands in your project as a file you own.

What is the Runs with brush component?

It is one <RunsWithBrush> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is runs and success rate per hour, events.

Sizes XS, S, M and L re-lay the chart out from the data instead of scaling it, so labels stay readable at every size.

When should I use it?

  • Do events explain the changes? Yes means the runs with brush fits.
  • Is a week the right range? Yes means the runs with brush fits.
  • Is it volume and rate together? Yes means the runs with brush fits.

When does another type fit better?

  • Just the trend. Use Bar and line combo instead.
  • A few hours against a target. Use Target trend instead.
  • One measure only. Use Line chart instead.

Runs with brush questions

Installing, data, Figma and plans.

  • Yes. It installs through the shadcn registry with the shadcn CLI, and the file lands in your project.

Stay in the loop

New charts, by email.

Get an email when new chart types and releases ship.

Unsubscribe any time.