@swampadmin/finops-toolkit
v2026.02.28.0
Multi-cloud FinOps toolkit for cost visibility, trend analysis, and anomaly detection.
Reports
- Cost by Service — breakdown by cloud provider and service
- Cost Trend — week-over-week and month-over-month timeseries
- Anomaly Detection — ML-based spike detection with configurable thresholds
Repository
https://github.com/swamp-club/finops-toolkit
Labels
finopscostcloudreporting
Install
$ swamp extension pull @swampadmin/finops-toolkitRelease Notes
Initial release with AWS and GCP cost models, weekly review workflow, and three report types.
Coming soon: Azure cost model, budget alerts, and Slack notification integration.
@swampadmin/finops-toolkit/aws-costsv1.0.0aws-costs.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| account_ids | array | Cloud account identifiers to query |
fetchfetch operation
| Argument | Type | Description |
|---|---|---|
| account_id | string | Cloud account identifier |
| date_range? | string | Date range (e.g. 'last-30d') |
aggregateaggregate operation
| Argument | Type | Description |
|---|---|---|
| group_by | string | Grouping dimension (service, region, tag) |
comparecompare operation
| Argument | Type | Description |
|---|---|---|
| name | string | Resource name |
@swampadmin/finops-toolkit/gcp-costsv1.0.0gcp-costs.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| account_ids | array | Cloud account identifiers to query |
fetchfetch operation
| Argument | Type | Description |
|---|---|---|
| account_id | string | Cloud account identifier |
| date_range? | string | Date range (e.g. 'last-30d') |
aggregateaggregate operation
| Argument | Type | Description |
|---|---|---|
| group_by | string | Grouping dimension (service, region, tag) |
Weekly Cost Reviewweekly-cost-review
Weekly Cost Review workflow
weekly-cost-review-jobExecute Weekly Cost Review
1.Fetch AWS@swampadmin/finops-toolkit/aws-costs.fetch— Fetch AWS step
2.Fetch GCP@swampadmin/finops-toolkit/gcp-costs.fetch— Fetch GCP step
3.Aggregate@swampadmin/finops-toolkit/aws-costs.aggregate— Aggregate step
cloud-credentialsconfigurable
vault-providercloud-creds.ts
cloud-credentials secrets provider
Config Fields
| Field | Type | Description |
|---|---|---|
| provider | string | Cloud provider (aws, gcp, azure) |
| credential_path? | string | Path to service account credentials file |
cost-by-servicemodel
cost-by-service.ts
Itemized cost breakdown by cloud provider and service category with month-over-month comparison
costfinopsbreakdown
cost-trendworkflow
cost-trend.ts
Weekly and monthly cost trend timeseries with linear projection and budget threshold markers
costtrendtimeseries
anomaly-detectionmodel
anomaly-detection.ts
ML-based spend anomaly detection with configurable sensitivity thresholds and Slack alert integration
costanomalyalerts