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.--nameto label it,--expires-atto set an expirycirron keys list <deploymentId>shows prefixes, names, and expiry dates, never the secretcirron keys rotate <deploymentId> <keyId>issues a replacement and revokes the old key, which stops working within about 30 secondscirron keys revoke <deploymentId> <keyId>revokes a key after confirmation;--yesskips it
Deployment access
cirron access get <deploymentId>shows whether the URL requires a keycirron access set <deploymentId> --public | --privateopens or closes keyless access. Going public asks for confirmation;--yesskips it
Push, pull, and sync
cirron push --platform <slug>, orplatform:incirron.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 pullandcirron syncnow refuse file paths from the platform that point outside your project directory.- Fixed
cirron syncrecording the wrong checksum after a keep-both conflict resolution. - Removed
--registryfromcirron pushandcirron pull. It never had any effect. Use--platformto choose where an artifact is stored.
Apple Silicon
- New
mpstarget for PyTorch projects on Apple Silicon. Projects using the Apple Silicon hardware preset now build formpsinstead of failing CUDA validation. You can also pass--arch mps.
Bug Fixes
- Fixed the interactive architecture prompt in
cirron buildandcirron compilebuilding the original architecture instead of the one you picked. - Fixed
cirron plan save --allfailing on a machine without saved plans. - Fixed
cirron deploywaiting 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.
--verbosenow shows detailed logs. cirron compile,cirron plan compile, andcirron plan buildnow exit with a non-zero code when they fail. CI jobs that were passing on failed compiles will now fail.- Fixed
cirron settingsandcirron configaccepting unsafe key paths such as__proto__. - Updated dependencies to their latest versions, including security fixes.
August 6, 2026
Bug Fixes
- Fixed
deploy,logs, andenvrejecting the standard login. - Fixed
status --remote,build, andinitfailing 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 deployfailing 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 initscaffolds projects. Can start from scratch or use PyTorch, TensorFlow, scikit-learn, or custom templates, with inference and training variantscirron compile,cirron build, andcirron deploytake a project from source to a deployed endpoint, driven bycirron.yamlcirron testruns the built-in suite for ML environments, data pipelines, and inference
Run and inspect
cirron run pipeline | job | inference | sweepto launch work, withstatus,logs, andcancelfor in-flight runscirron replayre-executes a recorded run for reproducibilitycirron listandcirron infosummarize project and platform state
Local-first profiling
cirron traces view | list | export | clearoperates directly on the SDK’s./.cirron/directory to render a flamegraph in the terminal, list sessions, or export tracescirron spool inspect | flush | clearmanages the on-disk spool and ships artifacts to the platform when you’re readycirron traces snapshotsandcirron traces snapshotsurface weight and gradient snapshots from the spool
Plan, sync, and diagnose
cirron plan compile | build | diff | savepreviews execution and persists plans for reviewcirron push,cirron pull, andcirron syncmove artifacts between the local project and the platformcirron doctor,cirron diagnostics,cirron hardware, andcirron lintvalidate the environment before a run
Auth and config
cirron auth login | logout | status | refreshfor API keys and session statecirron config,cirron settings, andcirron envfor global, project, and per-environment configuration
Install
npm install -g @cirron/clicurl -fsSL https://cli.cirron.com | bash- Standalone binaries for linux-x64, macos-x64, macos-arm64, and win-x64