v2.2.4

Control Plane AI Plugin

What changed

Changed

• Adding a BYOK location to a GVC now uses the update_gvc tool.

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v2.2.3...v2.2.4

v2.2.3

Control Plane AI Plugin

What changed

Fixed

• Creating or updating a volume set now requires the storage skill first, closing the last create and update tools that could run without one.
• Shared volume set manifests now spell out the CPU and memory bounds on mountOptions.resources, including that leaving one bound out lets the default fill it in and trip the ratio check.
• Apply failures now explain that cpln apply reports every rejected resource rather than stopping at the first, so a workload complaining about a non-existent volume set is a cascade of the earlier failure and not a missing dependency.

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v2.2.2...v2.2.3

v2.2.2

Control Plane AI Plugin

What changed

Fixed

• The plugin no longer fails to load its hooks in Claude Code, which now loads the standard hooks file automatically.
• The scaling metric table no longer calls CPU the default for standard workloads, contradicting the note directly below it.

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v2.2.1...v2.2.2

v2.2.1

Control Plane AI Plugin

What changed

Fixed

• Capacity AI works on every workload type, defaulting off on stateful and vm, and on cron it applies at the next scheduled run.
• A standard workload with no named autoscaling metric ends up with autoscaling disabled.

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v2.2.0...v2.2.1

v2.2.0

Control Plane AI Plugin

What changed

Changed

• Running a command inside a live container is now directed to the cpln CLI everywhere, because the MCP server no longer exposes an exec tool, while listing a workload's running replicas continues to work through MCP.

Fixed

• Asking whether workloads can run on your own bare metal, on-prem VMs, or data-center servers now routes to the mk8s and BYOK skill instead of returning cloud regions, and that skill explains both routes to turning your hardware into a location along with the node minimums that decide which one applies.
• The skill router previously had no entry for Kubernetes clusters at all, and sent anything mentioning on-prem to private networking even when the user wanted to run there rather than connect to it.

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v2.1.2...v2.2.0

v2.1.2

Control Plane AI Plugin

What changed

Added

• The guardrails describe the new readonly MCP toolset profile and how to work within it.

Changed

• Skill availability notes no longer promise that deletes work on every profile — delete_resource is absent from readonly.

Fixed

Removed

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v2.1.1...v2.1.2

v2.1.1

Control Plane AI Plugin

What changed

Changed

• GVC and IP set locations are validated against the organization's own location list, so any location it has is usable.
• The guardrails and the Kubernetes migration agent state that the organization's location list is the authority on which locations exist.

Fixed

• The GVC and IP set location tools no longer reject BYOK or built-in Oracle Cloud (oci-*) locations as unknown.
• A BYOK location whose name matches a built-in region's friendly name is no longer swapped for that region.

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v2.1.0...v2.1.1

v2.1.0

Control Plane AI Plugin

What changed

Added

• When a task needs a secret that does not exist, the plugin now offers a placeholder manifest for the user to fill in and apply, documenting every secret type's accepted data shape, including the JSON string forms for docker, gcp, and azure-sdk.
• build_image and get_image_build build a container image from a GitHub or GitLab repository and report its progress.
• Remote image builds with cpln image build --remote, which run on Control Plane instead of local Docker.

Changed

• The OpenTelemetry logging workflow accepts an existing Control Plane credentials-secret reference but no longer accepts raw authentication headers.
• Credential-bearing prompts are refused without an MCP, skill, or CLI call; credential operations may resume only by referencing a secret created outside the conversation.
• CI/CD guidance now offers remote builds as an option for runners without a Docker daemon.

Fixed

• The skills and guardrails no longer claim that every image build needs a local Docker daemon.

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v2.0.0...v2.1.0

v2.0.0

Control Plane AI Plugin

What changed

Added

• Listed on the official MCP registry as io.cpln/control-plane (server.json).

Changed

• Secrets are now read-only for AI: listing and reading return metadata only, and no tool or skill creates, edits, deletes, or reveals a secret — manage secret data in the Console, CLI, Terraform, Pulumi, or the API.
• workload_reveal_secret is now grant_workload_secret_access — the same one-call workload access grant; it never returns secret values.
• The core toolset grew to 54 tools, adding distributed traces, cron run trigger, replica stop, async command status, and quota listing.

Fixed

• Corrected Antigravity command notes and stale component counts.
• logql-observability: --from/--to accept relative durations (7d, now-1M) in addition to ISO 8601 timestamps.
• audit-compliance: clarified that billing is processed externally by Stripe and Control Plane stores no cardholder data.

Removed

• All secret create/update tools, reveal_secret, and the Terraform export option that embedded secret values.

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v1.6.0...v2.0.0

v1.6.0

Control Plane AI Plugin

What changed

Added

• Antigravity CLI (agy) support.

Changed

• Every client now connects to the MCP server with the full toolset.

Removed

• Gemini CLI support — use Antigravity CLI (agy) instead.

---

Update an existing install

If you already have the plugin installed, use the per-client commands below to pull this release. None of these clients auto-update third-party plugins by default.

Claude Code

/plugin marketplace update controlplane
/reload-plugins

To opt into auto-updates for future releases, run /plugin, open the Marketplaces tab, select Control Plane, and choose Enable auto-update.

Codex

codex plugin marketplace upgrade controlplane

Restart Codex so the upgraded plugin manifest is picked up.

Antigravity CLI

Antigravity has no dedicated update command — reinstall to pull the latest:

agy plugin uninstall cpln
agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

First-time install

Claude Code

/plugin marketplace add https://github.com/controlplane-com/ai-plugin.git
/plugin install cpln@controlplane
/reload-plugins

Codex

codex plugin marketplace add https://github.com/controlplane-com/ai-plugin.git

Then start Codex, open /plugins, and install cpln from the Control Plane marketplace.

Antigravity CLI

agy plugin install https://github.com/controlplane-com/ai-plugin/plugins/cpln

Generic MCP client — point it at https://mcp.cpln.io/mcp. OAuth 2.1 sign-in handles authorization on first use. See README for the config snippet.

---

Full changelog: v1.5.1...v1.6.0