basetenlabs/baseten-cli v0.2.0

v0.2.0

Repository: basetenlabs/baseten-cli

Tag: v0.2.0

Published: 2026-06-24T16:31:20Z

Prerelease: no

Release notes: Download binaries below or see README for install

Highlights

⚠️ This is a pre-release and is not considered stable. CLI structure and output may change before GA.

New Commands

• `model-api`: list and call Baseten Model APIs (shared inference endpoints)
• model-api list: list added Model APIs (--all browses the full catalog)
• model-api describe --model : show details for one Model API
• model-api predict: send an inference request via --content (chat-completions from a message), --data (inline JSON), or --file; supports text, JSON, and JSONL streaming output
• `model watch`: watch a local model directory and live-patch its development deployment on each change, no full rebuild (--hot-reload, --no-keepalive)
• `model deployment metrics`: fetch deployment metrics with --mode current|summary|series (series renders as sparklines, or a table with --no-chart); window via --start/--end or --since (max 7d); filter with repeatable --metric
• `org billing usage`: render a usage table broken down by category (Dedicated, Model APIs, Training) with CATEGORY, MINUTES, TOTAL, CREDITS, SUBTOTAL columns and an "All" total row; --since accepts a duration (e.g. 30d)

New Flags

• `model push`: --develop (push to the mutable dev slot), --watch (live-patch after push; implies --develop), --watch-hot-reload, --watch-no-keepalive
• `model deployment logs`: --min-level, --includes/--excludes (repeatable substring filters), --search-pattern (RE2 regex), --replica, --request-id
• `auth login`: --profile (name the stored profile), --remote-url, --no-switch

Improvements

• Named auth profiles: auth moved from a host/label model to named profiles, selectable via --profile or BASETEN_PROFILE; auth switch changes the current profile and auth logout/auth status operate per-profile
• `auth login`: browser-based login now opens the browser automatically using the full device-flow verification URI

💥 Backwards-Incompatible Changes

• `model push --promote` removed: use --environment production instead
• `auth login --label` renamed to `--profile`
• Auth reworked around named profiles: auth logout/auth switch/auth status now operate on profiles rather than host/user pairs
• Commands renamed (fetch becomes describe):
• model fetch becomes model describe
• model deployment fetch becomes model deployment describe
• model environment fetch becomes model environment describe

What's Changed

• Update README for v0.1.0 release by @cretz in https://github.com/basetenlabs/baseten-cli/pull/12
• Open browser and use complete verification URI for auth login by @cretz in https://github.com/basetenlabs/baseten-cli/pull/14
• Add per-platform install one-liners to README and CI version check by @cretz in https://github.com/basetenlabs/baseten-cli/pull/15
• Add filter flags to model deployment logs by @cretz in https://github.com/basetenlabs/baseten-cli/pull/16
• Replace host/label auth model with named profiles by @cretz in https://github.com/basetenlabs/baseten-cli/pull/17
• Add model-api commands (fetch, list, predict) by @cretz in https://github.com/basetenlabs/baseten-cli/pull/18
• Remove --promote flag from model push by @cretz in https://github.com/basetenlabs/baseten-cli/pull/19
• Add model deployment metrics command by @cretz in https://github.com/basetenlabs/baseten-cli/pull/20
• Teach org billing usage to stop panicking about money by @quinnypig in https://github.com/basetenlabs/baseten-cli/pull/21
• Add model watch and push --watch live-patch loop by @cretz in https://github.com/basetenlabs/baseten-cli/pull/22
• 💥 Rename fetch command verb to describe by @cretz in https://github.com/basetenlabs/baseten-cli/pull/23

Full Changelog: https://github.com/basetenlabs/baseten-cli/compare/v0.1.0...v0.2.0