Releases: cycloidio/cycloid-cli
Release list
v6.10.194-rc
[ci skip] v6.10.164 release
v6.10.191-rc
[ci skip] v6.10.164 release
v6.10.190-rc2
[ci skip] v6.10.164 release
v6.10.164
[v6.10.164] 2026-07-02
Cycloid CLI changelog:
Inventory
ADDED
- New
cy inventorycommands to browse Terraform state inventory.cy inventory outputs listandcy inventory resources listsupport project/environment/component scoping, curated filter flags, and a generic repeatable--filter 'attribute[condition]=value'.cy inventory outputs get <key>prints the raw output value (scriptable), or the full object with-o json. (CLI#469)
Service Catalog
ADDED
- New
cy beta template rendercommand to render Cycloid stack templates locally, with no backend. Supports layered context (component base < context file < stdin/string <--setoverrides), placeholder rendering for unset variables, and multi-file/--dir/stdin input. (CLI#459)
v6.10.164-rc
[v6.10.164-rc] 2026-07-02
Cycloid CLI changelog:
Inventory
ADDED
- New
cy inventorycommands to browse Terraform state inventory.cy inventory outputs listandcy inventory resources listsupport project/environment/component scoping, curated filter flags, and a generic repeatable--filter 'attribute[condition]=value'.cy inventory outputs get <key>prints the raw output value (scriptable), or the full object with-o json. (CLI#469)
Service Catalog
ADDED
- New
cy beta template rendercommand to render Cycloid stack templates locally, with no backend. Supports layered context (component base < context file < stdin/string <--setoverrides), placeholder rendering for unset variables, and multi-file/--dir/stdin input. (CLI#459)
v6.10.25
[v6.10.25] 2026-06-19
Cycloid CLI changelog:
Authentication
ADDED
- OIDC group mapping commands:
cy oidc mappings,cy oidc settings, andcy oidc integration(CLI#452)
Manage OIDC-driven org access from the CLI: map IdP group claims to teams (cy oidc mappings create|list|delete), configure per-org reconciliation (cy oidc settings set— default role, oidc-managed mode, no-match policy), and set up the OIDC SSO integration including the groups claim name (cy oidc integration set).
v6.10.25-rc
[v6.10.25-rc] 2026-06-19
Cycloid CLI changelog:
Authentication
ADDED
- OIDC group mapping commands:
cy oidc mappings,cy oidc settings, andcy oidc integration(CLI#452)
Manage OIDC-driven org access from the CLI: map IdP group claims to teams (cy oidc mappings create|list|delete), configure per-org reconciliation (cy oidc settings set— default role, oidc-managed mode, no-match policy), and set up the OIDC SSO integration including the groups claim name (cy oidc integration set).
v6.10.24
[v6.10.24] 2026-05-27
Cycloid CLI changelog:
Environments
ADDED
- Org-scoped environment management commands:
cy environment,cy cloud-account, andcy environment-type(CLI#445)
New commands let you create, update, get, list, and delete org-level environments (decoupled from pipelines), attach cloud accounts, set environment types, and link/unlink environments to projects. Environment type on create is now optional — the API auto-detects it from canonical keywords.
v6.10.24-rc
[v6.10.24-rc] 2026-06-19
Cycloid CLI changelog:
v6.10.8
[v6.10.8] 2026-05-24
Cycloid CLI changelog:
CLI
ADDED
-
cy plugin registry plugin version install --retryto idempotently install a plugin version (CLI#432)
Adds--retryflag tocy plugin registry plugin version install. When the install returns HTTP 409 (already installed), the command retries via the retry endpoint instead of failing. Safe for use in CI/CD pipelines. -
cy plugin registry plugin version publish --docker-imageto publish Docker image-based plugin versions (CLI#426)
Adds--docker-imageas a mutually exclusive alternative to--urlin the version publish command. Accepts Docker image references (e.g.registry:5000/org/plugin:tag) that are not valid URIs, which the existing--urlflag rejects. -
--stack-versionflag oncy component create,cy component update,cy stacks get-config, andcy beta config interpolateunifies stack version selection. Accepts a bare value (auto-detected as tag, branch, or commit hash) or an explicit type prefix:tag:<name>,branch:<name>,sha:<hash>. Shell completion is prefix-aware:--stack-version=tag:<TAB>lists tags only. (CLI#)
Bare values are resolved via ListStackVersions with precedence tag > branch > commit-hash-prefix (min 7 chars). Collisions between a tag and branch of the same name produce an actionable error with prefix-form hints. Prefixed values require no API call. -
Added delete options (skip-hooks, ignore-config-files-err) to delete component/environment/project (CLI#440)
-
Added
cy organization licence activateandcy organization licence getcommands (CLI#)
CHANGED
--outputnow supports table column selection, jq expressions, and field extraction (CLI#999)
Extended--outputgrammar:table=col1,col2selects specific columns;table:noheadersuppresses the header row;jq=<expr>runs an arbitrary jq expression over the full JSON response; any other value (e.g.canonical,owner.username) extracts that field, one value per line. A--jq <expr>flag was added as shorthand for-o jq=<expr>. Shell completion for--outputis now model-aware:cy project list -o <tab>suggests model fields alongsidejson,yaml,table, andjq=. Pipe pattern enabled:cy project delete $(cy project list -o canonical). Default table columns are curated per resource (e.g. projects show Canonical, Name, Description, Owner).- Table output has been reworked: configurable borders, dynamic column expansion, and persistent default output format (CLI#999)
The default table uses a kubectl-style separator (─) between header and rows. A newtable:borderoption switches to nushell-style rounded-border grid (╭─┬─╮). On wide terminals, extra struct fields are shown beyond the curated defaults; as the terminal narrows, extra columns are dropped first while curated columns are preserved. Nested structs render as{record N fields}instead of the type name. A newcy output set <value>command persists the default output format to~/.config/cycloid-cli/config.yaml;cy output getshows the current effective value;cy output resetclears it. TheCY_OUTPUTenvironment variable sets the default at runtime. Priority:--jq>--output>CY_OUTPUT>cy output set>table. cy beta plugincommands promoted to top-levelcy plugin(CLI#426)
Plugin management commands are no longer experimental.cy beta pluginis removed; usecy plugininstead. This release also addscy plugin registry update,cy plugin registry plugin update,cy plugin component list/relation-set,cy plugin widget list/query, andcy plugin component widget list/query.
DEPRECATED--stack-tag,--stack-branch, and--stack-commit-hashflags are deprecated in favour of--stack-version. They remain functional and will be removed in the next major release. (CLI#)
Migrate: --stack-tag=v1.0.0 → --stack-version=tag:v1.0.0 | --stack-branch=main → --stack-version=branch:main | --stack-commit-hash=abc123 → --stack-version=sha:abc123
FIXEDcy plugin manager createnow fully registers the plugin manager instead of leaving an unresolvable pending invitation (CLI#443)
Previously the create command sent the invitation-only request, producing aninvite_pendingrow that the Plugin Manager never received and that could not be accepted or deleted. The command now sendsauto_register: trueso the Plugin Manager is contacted and activated in one step.
Pipelines Overview
ADDED
cy pipeline builds logsandcy pipeline job logsto stream build event logs from past and in-progress builds (CLI#426)
builds logs --build-id <id>dumps the event log for a specific build (or tails it with--watch).job logsfetches the latest build's logs for a job; with--watchit continuously tails future builds as they start, polling at a configurable--poll-interval.