Installation

The Konductro CLI plugin takes a few minutes to set up. You need Node.js, an IDE that supports MCP, and a personal CLI token from Konductro.

Prerequisites

Node.js 18+ installed
Claude Code, Amazon Q (Kiro CLI), OpenAI Codex, or Cursor as your AI coding tool
A Konductro account with project access

Install the Plugin

The Konductro plugins are published to the public npm registry under the @konductro scope. No registry configuration or authentication is required.

For Claude Code:

npm install -g @konductro/claude-plugin

For Amazon Q (Kiro CLI):

npm install -g @konductro/q-plugin

For OpenAI Codex:

npm install -g @konductro/codex-plugin

For Cursor:

npm install -g @konductro/cursor-plugin

Generate a CLI Token

Open your profile

In Konductro, click your avatar to open your profile, then open the Git & Credentials tab.

Create a token

Under CLI Access, type a name for the token (for example "MacBook, Claude Code") and click Generate. Copy the token straight away: it is shown only once.

Configure the plugin

Run the setup command with your Konductro platform URL and CLI token:

# Claude Code plugin
konductro-claude-setup --url https://platform.konductro.com --token <your-cli-token>
 
# Amazon Q (Kiro CLI) plugin
konductro-q-setup --url https://platform.konductro.com --token <your-cli-token>
 
# OpenAI Codex plugin
konductro-codex-setup --url https://platform.konductro.com --token <your-cli-token>
 
# Cursor plugin
konductro-cursor-setup --url https://platform.konductro.com --token <your-cli-token>

Replace <your-cli-token> with the token you copied in the previous step. If your organisation uses a self-hosted instance, replace the URL accordingly.

The setup command registers the MCP server with your IDE and stores the connection configuration locally.

Verify the Connection

After setup, open your AI coding tool in any folder and ask, in plain language:

What's on my Konductro list?

If the plugin is connected, the AI lists the tickets assigned to you, or tells you that you have none. An error about the token or the URL means setup needs to be run again.

The four tools start Konductro commands differently. See Starting a command in each AI coding tool on the CLI overview.

Updating

An update has two steps: install the new version, then re-run the plugin's setup with the same URL and token. Every setup copies files out of the installed package, so installing alone can leave the old version running.

# Claude Code
npm install -g @konductro/claude-plugin@latest
konductro-claude-setup --url https://platform.konductro.com --token <your-cli-token>
 
# Amazon Q (Kiro CLI)
npm install -g @konductro/q-plugin@latest
konductro-q-setup --url https://platform.konductro.com --token <your-cli-token>
 
# OpenAI Codex
npm install -g @konductro/codex-plugin@latest
konductro-codex-setup --url https://platform.konductro.com --token <your-cli-token>
 
# Cursor
npm install -g @konductro/cursor-plugin@latest
konductro-cursor-setup --url https://platform.konductro.com --token <your-cli-token>

Troubleshooting

Problem	Solution
`EACCES` permission error	Use `sudo` or fix npm global permissions
Token rejected	Check the token has not been revoked under CLI Access in your profile
A technical analysis is refused with an upgrade message	The project uses a document template and your plugin is too old to follow it. Install the latest version and re-run setup, as under Updating above
Plugin not recognised by IDE	Restart the IDE after installation
Connection timeout	Check that `platform.konductro.com` is reachable from your network