kimi

Claude Code Kimi Plugin

Use Kimi CLI from Claude Code for direct questions and delegated tasks.

English | 中文

This repository is structured like openai/codex-plugin-cc:

• the repository root is a Claude marketplace package via .claude-plugin/marketplace.json
• the actual plugin lives in plugins/kimi
• slash commands call plugins/kimi/scripts/kimi-companion.mjs

Features

• Ask Kimi directly from Claude Code with /kimi:ask
• Delegate longer tasks with /kimi:delegate
• Track background jobs with /kimi:status, /kimi:result, and /kimi:cancel
• Keep job state in a user-scoped directory instead of polluting the repo

Requirements

• Claude Code with plugin support
• Node.js >= 18.18.0
• Kimi CLI installed and authenticated

Install and log in to Kimi CLI first:

npm install -g @moonshot-ai/kimi-cli
kimi login

Install

Install From GitHub

Inside a Claude Code session:

/plugin marketplace add https://github.com/Loner1024/claude-kimi-plugin.git
/plugin install kimi@moonshot-kimi
/reload-plugins
/kimi:setup

Or with the Claude CLI:

claude plugin marketplace add https://github.com/Loner1024/claude-kimi-plugin.git
claude plugin install kimi@moonshot-kimi
claude -p '/kimi:setup'

Load Locally For Development

If you want to test local changes without reinstalling:

claude --plugin-dir /path/to/claude-kimi-plugin/plugins

For a quick non-interactive check:

claude -p --plugin-dir /path/to/claude-kimi-plugin/plugins '/kimi:ask reply exactly: ok'

Verify Setup

Run:

/kimi:setup

Expected output includes:

• Kimi CLI found
• the detected Kimi CLI version
• whether ~/.kimi/config.toml exists

Commands

• /kimi:setup Check whether Kimi CLI is installed and configured.
• /kimi:ask <question> Send one prompt to Kimi and return the final text output.
• /kimi:delegate --wait <task> Run a delegated task in the foreground and wait for the result.
• /kimi:delegate --background <task> Start a background task and return immediately.
• /kimi:status [job-id] Show all jobs for the current workspace or one specific job.
• /kimi:result [job-id] Show the latest finished result or a specific job result.
• /kimi:cancel [job-id] Cancel a running job.

Usage Examples

Ask a direct question:

/kimi:ask Who are you?

Delegate in the foreground:

/kimi:delegate --wait Review the current repo for the riskiest regression points

Delegate in the background:

/kimi:delegate --background Analyze the current codebase and list the top 3 risks
/kimi:status
/kimi:result

How It Works

The runtime path is:

Claude slash command
  -> plugins/kimi/commands/*.md
  -> node "${CLAUDE_PLUGIN_ROOT}/scripts/kimi-companion.mjs" <subcommand>
  -> kimi --quiet --prompt "<prompt>"

Job state is stored under:

~/.claude-kimi-plugin/workspaces/<workspace-hash>/jobs

Development

Run tests:

npm test

Validate the manifests:

claude plugin validate .claude-plugin/marketplace.json
claude plugin validate plugins/kimi/.claude-plugin/plugin.json

Notes

• The minimal working path is based on kimi --quiet --prompt ...
• ACP is not the primary runtime in this version
• Kimi CLI appends To resume this session: ... to output, and the companion strips it automatically