aai agency logo

Installation

Get started

Install
$ pnpm add @aai-agency/og-components
Paste into Claude Code, ChatGPT, or Codex
Install @aai-agency/og-components and build a synchronized ChartGroup for an oil & gas asset.

```bash
pnpm add @aai-agency/og-components
```

Use stable series IDs for oil, gas, and water actuals and forecasts. Add a derived variance bar chart plus daily pressure and hourly vibration panels. Keep the X window, cursor, and annotations synchronized while every chart retains its own Y-axis and controls.
Unified Charts & Annotations

Compose production, forecasts, derived variance, and operational annotations across synchronized line and bar charts. Every panel shares time context while retaining its own scale and controls.

MONTHLYActual + forecast
DERIVEDID-based variance
DAILYTubing pressure
HOURLYPump vibration
Production — actuals & forecastsline
  • Oil actual
  • Oil forecast
  • Gas actual
  • Gas forecast
  • Water actual
Plan variance — derived from oil.actual + oil.planbar
  • Oil vs plan
Tubing pressure — dailyline
  • Tubing pressure
Pump vibration — hourlyline
  • Pump vibration
Hover a shaded annotation to read its operational context.Independent Y · shared X
Read the composition guide →
Map

Loading well data...

Chart · interactive forecast

Add the forecast layer to a line Chart for interactive decline editing, operational annotations, and an ID-derived variance panel.

Variance · actual minus forecastbar
EventTimeline

A full asset history in one filterable feed. A well's lifecycle here, but any asset works: facilities, pads, pipelines, equipment. Click any event to open its detail dialog: an AI-generated summary up top, then tags, details, attachments, and a scrollable operations log.

Asset history16 events
2021
2022
2023
2024
2025

AI summary

Click any event and this is what opens: its detail record, led by a short AI-generated summary so nobody has to read the full report first. The workover's, straight from the sample data:

Rod pump repair
Intervention
Summary AI
Rod string parted and the pump was worn. Pulled everything, replaced the pump and 18 rods, and put the well back on production. Took 13 days.
Date
Aug 30, 2022 – Sep 12, 2022 · 13 days
Tags
WorkoverIntervention
Description
The rod string parted near 4,200 ft. Rigged up a workover rig, pulled the rod string and tubing, replaced the downhole pump and 18 worn rods, ran a new pump, and returned the well to production. Tubing and casing checked out fine.

On the roadmap

What we are building next. Star the repo to get notified.

KMZ Map Support
Coming soon

Upload and render KMZ/KML overlays directly on the map.

Map Annotations
Coming soon

Draw, label, and pin notes on the map.

Asset Table
Coming soon

High-performance sortable table for assets and production trends.

Want to talk about your project?