# AI Agent Integration

Sidekick is purpose-built for AI agent workflows. Here's how to connect it to your agent.

## Claude Code plugin

Install Sidekick as a Claude Code plugin:

```bash
claude plugin marketplace add hesedcasa/sdkck
claude plugin install sidekick@sidekick
```

## MCP server

Run Sidekick as an MCP server to expose every CLI command as a tool. Add to your `.mcp.json`:

```json
{
  "mcpServers": {
    "sdkck": {
      "command": "sdkck",
      "args": ["mcp", "start"]
    }
  }
}
```

Two tools are exposed:

- **`search_tools`** — Keyword search over all available commands; returns matching command IDs and descriptions
- **`run_command`** — Execute any command by ID with a JSON args object

Command IDs accept both `"api import"` and `"api:import"` — both resolve to the same command.

## AGENT.md instructions

Add this to your `AGENT.md` or `CLAUDE.md` so your agent knows to use Sidekick:

```
Before any tool call run `sdkck commands | grep <keywords>` to find the available tools in sdkck,
e.g.: `sdkck commands | grep -i "jira|issue"`
```

## Example agent workflow

```
Agent: I need to check recent Sentry errors and create a Jira ticket.

> sdkck search "sentry errors"          # Discovers the right command
> sdkck sentry issues list --recent     # Gets the data
> sdkck jira issue create ...           # Acts on it
```

## Works with

Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Google Gemini, opencode, and any agent that can run shell commands.
