rul1an/llm-cost
Estimate LLM costs in CI, enforce budgets, and (optionally) post sticky PR comments via llm-cost ci-action.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| command | Command to run: 'ci-action' (default), 'check', 'estimate', 'convert'. | no | ci-action |
| format | Output format: 'text' (default) or 'sarif'. | no | text |
| args | Extra arguments to pass to the tool (e.g. --actuals foo.csv). | no | "" |
| actuals | Path to actuals file for check/governance (FOCUS-format CSV, e.g. actuals.csv). | no | "" |
| sarif-output | Output path for SARIF file (only if format=sarif). | no | llm-cost.sarif |
| fail-on-error | If false, do not fail the job on non-zero exit codes (annotation-only). | no | true |
| skip-install | If true, skip install.sh and use llm-cost already on PATH (for PR testing). | no | false |
| version | Release tag to install (e.g. v1.1.0). Use 'latest' to resolve via GitHub API. | no | latest |
| releases-repo | Repo that hosts llm-cost release assets (owner/name). | no | Rul1an/llm-cost |
| manifest | Path to llm-cost.toml. | no | llm-cost.toml |
| budget | Budget in USD (string, e.g. 1.00). If set, ci-action enforces it. | no | "" |
| fail-on-increase | Fail if cost delta > 0. | no | false |
| post-comment | true|false|auto. auto should skip posting on fork PRs. | no | auto |
| comment-threshold | Minimum absolute delta (USD) before commenting. | no | 0 |
| github-token | Token used for GitHub API (PR comments). Defaults to workflow github.token if omitted. | no | "" |
| verify | true|false. If true, require checksum verification. | no | true |
| sha256 | Optional expected sha256 for the downloaded binary (strong pin). | no | "" |
Outputs
| name | description |
|---|---|
| exit-code | Exit code returned by llm-cost. |
| sarif-file | Path to SARIF file produced (if format=sarif). |