Skip to main content
August 30, 2026

Inference keys

Managed deployment URLs require an inference key by default. Keys are scoped to one deployment.
  • cirron keys issue <deploymentId> prints the secret once. --name to label it, --expires-at to set an expiry
  • cirron keys list <deploymentId> shows prefixes, names, and expiry dates, never the secret
  • cirron keys rotate <deploymentId> <keyId> issues a replacement, then revokes the old key
  • cirron keys revoke <deploymentId> <keyId> revokes a key

Deployment access

  • cirron access get <deploymentId> shows whether the URL requires a key
  • cirron access set <deploymentId> --public | --private opens or closes keyless access. Going public asks for confirmation; --yes skips it
August 6, 2026

Bug Fixes

  • Fixed deploy, logs, and env rejecting the standard login.
  • Fixed status --remote, build, and init failing silently while signed in.
  • Fixed login timing out before you could finish authorizing in your browser.
  • Fixed request timeouts and retries not applying per attempt.
  • Resolved security advisories in bundled dependencies.
August 3, 2026

Requirements

  • Node.js 22.13 or later is now required, up from 20.19.

Bug Fixes

  • Fixed being signed out when your access token expired. Sessions now refresh and retry automatically.
  • Fixed cirron deploy failing against the platform.
  • Fixed build reporting failing silently.
  • Fixed commands returning empty results instead of platform data.
  • Fixed deployment status not matching between commands.
May 13, 2026

Initial Release

The Cirron CLI is now generally available. A single binary covers the project lifecycle, drives runs on the platform, and inspects local profiling artifacts produced by the SDK.

Project lifecycle

  • cirron init scaffolds projects. Can start from scratch or use PyTorch, TensorFlow, scikit-learn, or custom templates, with inference and training variants
  • cirron compile, cirron build, and cirron deploy take a project from source to a deployed endpoint, driven by cirron.yaml
  • cirron test runs the built-in suite for ML environments, data pipelines, and inference

Run and inspect

  • cirron run pipeline | job | inference | sweep to launch work, with status, logs, and cancel for in-flight runs
  • cirron replay re-executes a recorded run for reproducibility
  • cirron list and cirron info summarize project and platform state

Local-first profiling

  • cirron traces view | list | export | clear operates directly on the SDK’s ./.cirron/ directory to render a flamegraph in the terminal, list sessions, or export traces
  • cirron spool inspect | flush | clear manages the on-disk spool and ships artifacts to the platform when you’re ready
  • cirron traces snapshots and cirron traces snapshot surface weight and gradient snapshots from the spool

Plan, sync, and diagnose

  • cirron plan compile | build | diff | save previews execution and persists plans for review
  • cirron push, cirron pull, and cirron sync move artifacts between the local project and the platform
  • cirron doctor, cirron diagnostics, cirron hardware, and cirron lint validate the environment before a run

Auth and config

  • cirron auth login | logout | status | refresh for API keys and session state
  • cirron config, cirron settings, and cirron env for global, project, and per-environment configuration

Install

  • npm install -g @cirron/cli
  • curl -fsSL https://cli.cirron.com | bash
  • Standalone binaries for linux-x64, macos-x64, macos-arm64, and win-x64
Read the CLI documentation →