`gum gain`

Generated from gum schema --json. Do not edit this page by hand; run make docs-commands.

Print cumulative gain (token-savings) stats from the local ledger, or replay a fixture set with --fixture-replay.

Usage

bash

gum gain [flags]

Flag	Type	Default	Help
`--by-op`	`bool`	false	Aggregate gain by op_id
`--exclude-retries`	`bool`	false	Drop is_retry=true entries from the reported aggregate; the ledger file is unchanged
`--fixture-replay`	`bool`	false	Replay fixtures from testdata/fixtures/gain-replay
`--format`	`string`		Report format: text (default), json or csv. With --fixture-replay it selects the shaping format measured, json or toon, and defaults to toon
`--history`	`bool`	false	Report savings per session grouped by op_family, in ledger order
`--session`	`string`		Report one session: per-op rows grouped by op_id, cache status and field-mask status
`--since`	`string`		Filter ledger entries with ts >= since (RFC3339 UTC)
`--until`	`string`		Filter ledger entries with ts <= until (RFC3339 UTC)
`--log-format`	`string`	json	Log format: json\|text
`--log-level`	`string`	info	Log level: debug\|info\|warn\|error (overrides GUM_LOG_LEVEL)
`--profile`	`string`	default	Profile name to read/write config under