Add usage command

CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+## [Pending]
+
+### Added
+
+- `scout usage` command — show transaction usage across all apps for a given timeframe
+  - Calculates total transactions per app from throughput time-series data
+  - Fetches all apps in parallel for fast results
+  - Automatically splits timeframes longer than 14 days into chunked API requests
+  - `--by-day` flag for daily transaction totals
+  - `--by-day --by-app` shows daily breakdown per app with % of day, % of total timeframe, and top endpoints
+  - `--by-day --app <id>` shows daily breakdown for a single app with top endpoint
+  - `--all` flag to include apps with zero usage
+  - Displays timeframe and summary totals across all output modes
+  - Supports `--from`, `--to`, `--json`, and `--limit` flags
+
+## [0.1.0] - 2026-03-11
+
+### Added
+
+- Initial release of the Scout Monitoring CLI
+- `scout auth login/logout/status` — API key authentication
+- `scout apps list/show` — list and inspect applications
+- `scout metrics get` — fetch metric data with ASCII charts (apdex, response_time, response_time_95th, errors, throughput, queue_time)
+- `scout endpoints list/metrics` — list endpoints and view endpoint-level metrics
+- `scout traces list/show` — list and inspect traces with span trees
+- `scout errors list/show/occurrences` — list error groups and view occurrences
+- `scout insights list/show` — view performance insights (n_plus_one, memory_bloat, slow_query)
+- `scout setup` — show setup instructions for supported frameworks
+- Global flags: `--json`, `--app`, `--from`, `--to`, `--no-color`, `--limit`
+- Auto-detect piped output and switch to JSON
+- Homebrew installation via `scoutapp/tap`
+- CI/CD with GitHub Actions and GoReleaser

README.md

@@ -79,6 +79,18 @@ scout errors show 50560 --app 6
 scout errors occurrences 50560 --app 6
 ```
 
+### Usage
+
+```bash
+scout usage                                    # Transaction usage across all apps (last 3 hours)
+scout usage --from 30d                         # Last 30 days
+scout usage --from 7d --all                    # Include apps with zero usage
+scout usage --by-day --from 30d                # Daily totals
+scout usage --by-day --by-app --from 30d       # Daily breakdown per app with top endpoints
+scout usage --by-day --app 6 --from 30d        # Daily breakdown for one app with top endpoint
+scout usage --from 14d --json                  # JSON output
+```
+
 ### Insights
 
 ```bash
@@ -103,6 +115,7 @@ scout setup rails     # Show setup docs for a framework
 | `--app <id>` | Application ID (or set `default_app_id` in config) |
 | `--from <time>` | Start time — relative (`1h`, `7d`, `30m`, `2w`) or ISO 8601 |
 | `--to <time>` | End time (default: now) |
+| `-n, --limit <n>` | Max number of results to show |
 | `--no-color` | Disable colors (also respects `NO_COLOR` env) |
 
 ## Configuration