AI Plugin

Install

Claude Code
Codex
Gemini CLI

Add the marketplace, install the plugin, then reload:

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

To enable auto-update, run /plugin, use the < / > arrow keys to navigate to the Marketplaces tab, select controlplane, and choose Enable auto-update. Otherwise update manually with /plugin marketplace update controlplane followed by /reload-plugins.

Add the plugin marketplace:

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

Start Codex, open /plugins, navigate to Control Plane, then install the cpln plugin.

Enable plugin hooks for guardrail injection (recommended). Codex ships with plugin_hooks off by default. Enable it in ~/.codex/config.toml so the plugin’s SessionStart hook can inject CLI conventions and guardrails:

[features]
plugins = true
plugin_hooks = true

After restart, /plugins → Control Plane → Hooks should show SessionStart.

Codex does not auto-update plugin marketplaces. When a new release is published, run the upgrade command and restart Codex:

codex plugin marketplace upgrade controlplane

Install the extension from GitHub with auto-update enabled:

gemini extensions install https://github.com/controlplane-com/ai-plugin.git --auto-update

If you installed without --auto-update, pull the latest release manually:

gemini extensions update cpln
# or update every installed extension
gemini extensions update --all

In Gemini, commands drop the cpln: prefix — use /troubleshoot instead of /cpln:troubleshoot.

The plugin bundles the MCP server and auto-selects the toolset profile per client — Claude Code gets full, while Codex and Gemini CLI get core.

Each tool triggers OAuth its own way — see your tool’s setup page for the specifics. Once your browser lands on Control Plane:

Use Google, GitHub, Microsoft, or SAML.

Authorize orgs

Pick the orgs this AI client may access and click Authorize.

Try it

/cpln:troubleshoot my-api --gvc production

Install

Try it

Next steps

Usage Examples

AI Plugin on GitHub

​Install

​Sign in

​Try it

​Next steps

Usage Examples

AI Plugin on GitHub

Install

Sign in

Try it

Next steps