Skip to content

sofq/sku

Repository files navigation

(Alpha - unstable) sku — agent-friendly cloud & LLM pricing CLI

CI Release License

sku answers "what does this cost?" for AWS, Azure, Google Cloud, and OpenRouter in one pure-Go binary. JSON-everywhere, semantic exit codes, sub-30ms warm point lookups — purpose-built for AI agents that make programmatic pricing decisions.

Five-minute quickstart

# Install
brew install sofq/tap/sku         # or: npx @sofq/sku, pipx install sku-cli,
                                  # scoop install sku, docker run ghcr.io/sofq/sku

# Fetch pricing data (first run only)
sku update openrouter aws-ec2

# Point lookup
sku aws ec2 price --instance-type m5.large --region us-east-1 --pretty

# Cross-provider compare
sku compare --kind compute.vm --vcpu 4 --memory 16 --regions us-east --limit 5 --pretty

# Estimate monthly cost
sku estimate --item aws/ec2:m5.large:region=us-east-1:count=10:hours=730 --pretty

# Cheapest LLM for long context
sku llm price --model anthropic/claude-opus-4.6 --pretty

See docs/getting-started.md for the annotated walkthrough.

Why sku

  • Offline-first. Daily pricing data ships via sku update; the binary never calls provider APIs. Runs in airgapped CI.
  • Agent-shaped output. Every response is JSON; pipe into jq, or use --jq, --fields, and --preset to project what you need. Exit codes are a contract (docs/reference/exit-codes.md).
  • Four providers, one schema. AWS, Azure, GCP, and 70+ LLM serving providers via OpenRouter share a single price[] shape — cross-provider compare and search just work.
  • Pure Go, zero CGO. Cross-compiles to Linux / macOS / Windows × amd64 / arm64. Signed releases with SLSA L3 provenance and SBOMs.

Install

# Homebrew (macOS/Linux)
brew install sofq/tap/sku

# Scoop (Windows)
scoop bucket add sofq https://github.com/sofq/scoop-bucket
scoop install sku

# npm (JS/TS toolchains, uses platform-optional-dependencies)
npm i -g @sofq/sku        # or: npx @sofq/sku <cmd>

# PyPI (Python toolchains)
pipx install sku-cli       # or: pip install --user sku-cli

# Docker
docker pull ghcr.io/sofq/sku:latest
docker run --rm ghcr.io/sofq/sku:latest version

# Direct download (all else)
# see https://github.com/sofq/sku/releases

Full install doc including signature verification: docs/install.md.

Commands

Full per-command reference: docs/commands/.

Command Purpose
sku price / sku <provider> <service> price Point lookup
sku search Filter SKUs within one shard
sku compare Cross-provider equivalence
sku estimate Workload → monthly cost
sku batch NDJSON / JSON-array of multiple ops
sku schema Discover commands, error codes, serving providers
sku update Fetch / refresh a shard
sku configure Manage named profiles
sku version Build metadata (JSON)

Guides

Reference

  • Kinds — unified compute.vm, storage.object, db.relational, llm.text
  • Presetsagent, full, price, compare
  • Exit codes — the contract for automation

Security & support

About

(Alpha - Unstable) Agent-friendly CLI for cloud + LLM pricing

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors