l4 costs

l4 costs surfaces cloud-cost data — KPI summaries, per-service breakdowns, time-series, and the filter dimensions you can drill into.

Subcommands

Command	Purpose
`summary`	KPI overview: monthly spend, forecast, savings
`breakdown`	Per-service breakdown with filters, grouping, pagination
`daily`	Daily costs aggregated per day for a date range
`monthly`	Monthly costs aggregated per month
`filters`	Distinct values for every filter dimension

summary

l4 costs summary [--provider <id>]

KPI overview: monthly spend, forecast, total potential savings. Pass --provider to scope to one cloud (aws, gcp, azure, k8s).

l4 costs summary
l4 costs summary --provider aws
l4 costs summary --json

breakdown

l4 costs breakdown [flags]

Per-service cost breakdown with filters, multi-dimensional grouping, and pagination. The interactive split-pane TUI (--tui) lets you drill into rows and pivot grouping live.

Flags

Flag	Description
`--provider <id>`	`aws`, `gcp`, `azure`, `k8s` (auto-detected if omitted)
`--start <date>` / `--end <date>`	Date range, ISO 8601
`--preset <preset>`	`30D`, `6M`, `12M` (overrides `--start`/`--end`)
`--granularity <g>`	`daily` or `monthly`
`--group-by <dim>`	Repeatable: `service`, `account_id`, `region`, `tag`
`--service <s>`	Repeatable filter
`--region <r>`	Repeatable filter
`--account <a>`	Repeatable filter
`--environment <e>`	Repeatable filter
`--tag-key <k>` / `--tag-value <v>`	Required when `--group-by` includes `tag`
`--page` / `--page-size`	Pagination (max 100 per page)
`--sort-by <field>`	`cost`, `previous_cost`, `change_percentage`, `service`, `region`, `account_id`
`--sort-by-date <date>`	Sort by a specific date column (overrides `--sort-by`)
`--sort-order`	`asc` or `desc`
`--format`	`table`, `csv`, `raw` (default `table`)
`--tui`	Open the interactive split-pane viewer

Examples

l4 costs breakdown
l4 costs breakdown --preset 30D
l4 costs breakdown --start 2026-01-01 --end 2026-01-31
l4 costs breakdown --group-by service --group-by region
l4 costs breakdown --service EC2 --service RDS
l4 costs breakdown --group-by tag --tag-key Environment --tag-value production
l4 costs breakdown --granularity monthly --preset 6M
l4 costs breakdown --sort-by-date 2026-01-15 --sort-order desc
l4 costs breakdown --format csv > costs.csv

Filter options are cross-constrained (AWS Cost Explorer behavior): selecting a service narrows the regions and accounts you can subsequently filter on. Use l4 costs filters to discover the current option list at any point.

daily

l4 costs daily [--start <date>] [--end <date>] [--provider <id>]

Daily costs aggregated per day for the given date range. Default range is the trailing 30 days.

l4 costs daily
l4 costs daily --start 2026-01-01 --end 2026-01-31
l4 costs daily --json | jq '.data.data_points[]'

monthly

l4 costs monthly [--provider <id>]

Monthly costs aggregated per month across all available history.

l4 costs monthly
l4 costs monthly --json | jq '.data.data_points[]'

filters

l4 costs filters [dimension] [--start <date>] [--end <date>] [--provider <id>]

Discover the distinct values available for filtering the breakdown — services, regions, accounts, tag keys, tag values. Without an argument, prints every dimension; pass a dimension name to print just one.

l4 costs filters
l4 costs filters service
l4 costs filters region --start 2026-01-01 --end 2026-01-31
l4 costs filters --json | jq '.data.services[]'