Skip to main content
October 1, 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 and revokes the old key, which stops working within about 30 seconds
  • cirron keys revoke <deploymentId> <keyId> revokes a key after confirmation; --yes skips it

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

Push, pull, and sync

  • cirron push --platform <slug>, or platform: in cirron.yaml, names the Platform an artifact belongs to. Useful in CI, where there’s no project checked out.
  • Fixed pushes over 5 MB failing. Large files now upload in parts, with retries per part.
  • cirron pull and cirron sync now refuse file paths from the platform that point outside your project directory.
  • Fixed cirron sync recording the wrong checksum after a keep-both conflict resolution.
  • Removed --registry from cirron push and cirron pull. It never had any effect. Use --platform to choose where an artifact is stored.

Apple Silicon

  • New mps target for PyTorch projects on Apple Silicon. Projects using the Apple Silicon hardware preset now build for mps instead of failing CUDA validation. You can also pass --arch mps.

Bug Fixes

  • Fixed the interactive architecture prompt in cirron build and cirron compile building the original architecture instead of the one you picked.
  • Fixed cirron plan save --all failing on a machine without saved plans.
  • Fixed cirron deploy waiting five minutes when a deployment ended in a status like rolled back or stopped. It now reports the final status right away.
  • Fixed a 403 from the platform being reported as “Not signed in”. It now reports permission denied.
  • Errors now print as one line, without stack traces. --verbose now shows detailed logs.
  • cirron compile, cirron plan compile, and cirron plan build now exit with a non-zero code when they fail. CI jobs that were passing on failed compiles will now fail.
  • Fixed cirron settings and cirron config accepting unsafe key paths such as __proto__.
  • Updated dependencies to their latest versions, including security fixes.
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 →