sksidekick

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:

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:

{
  "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.