⚠️ This package has moved

This package is now maintained in the wopr-plugins monorepo.

This repository is archived and no longer accepts contributions.

---

🌙 wopr-plugin-provider-kimi

Moonshot AI Kimi Code CLI provider plugin for WOPR - Self-sovereign AI session management over P2P.

Kimi Code CLI is Moonshot AI's terminal-based AI agent for software development, offering powerful code generation, analysis, and task automation capabilities.

---

✨ Features

• 🚀 Auto-Installation - Automatically installs Python 3.12+, uv, and kimi-cli
• 🔐 OAuth Authentication - Secure OAuth2 login flow via Kimi Agent SDK
• 📝 Session Resumption - Resume previous conversations seamlessly
• ⚡ Streaming Responses - Real-time token streaming for interactive sessions
• 🎯 YOLO Mode - Auto-approve filesystem operations (enabled by default)
• 🔧 Kimi K2 Model - Full support for the Kimi K2 model
• 🖼️ Image Support - Include images in prompts for analysis
• 🔄 Multi-Session - Manage multiple concurrent Kimi sessions
• 🔗 A2A/MCP Support - Agent-to-Agent communication via MCP server configuration

---

📦 Installation

Prerequisites

• Node.js 18+ (for WOPR)
• Python 3.12+ (auto-installed if missing)
• uv (auto-installed if missing)

Plugin Installation

wopr plugin install wopr-plugin-provider-kimi

The plugin will automatically:

1. Check for Python 3.12+ and install via uv if missing
2. Install uv (Python package manager) if not present
3. Install kimi-cli tool via uv

Manual Installation

npm install -g wopr-plugin-provider-kimi

---

🔐 Authentication

The Kimi provider supports OAuth authentication.

OAuth Login

# The plugin uses OAuth - authenticate via Kimi's web flow
wopr providers auth kimi

This will:

1. Open your browser to the Kimi OAuth consent page
2. Request permissions for code access
3. Store the secure token in WOPR's credential store

Verify Authentication

wopr providers list

You should see kimi with a ✅ indicating successful authentication.

---

⚙️ Configuration

Quick Start

Create a session with default settings:

wopr session create my-kimi-session --provider kimi

With Options

wopr session create my-kimi-session \
  --provider kimi \
  --model kimi-k2 \
  --yolo-mode

Configuration Options

Option	Type	Default	Description
model	string	kimi-k2	Model to use for the session
workDir	string	/tmp	Working directory for the session
resume	string	-	Session ID to resume from
a2aServers	object	-	A2A/MCP server configuration for agent-to-agent communication

Note: YOLO mode (auto-approve filesystem operations) is always enabled in the current version.

JSON Configuration Example

{
  "provider": "kimi",
  "model": "kimi-k2",
  "workDir": "/home/user/projects",
  "a2aServers": {
    "my-tools": {
      "name": "my-tools",
      "version": "1.0.0",
      "tools": [
        {
          "name": "my_tool",
          "description": "A custom tool",
          "inputSchema": {}
        }
      ]
    }
  }
}

Note: YOLO mode is always enabled in this provider version.

See docs/CONFIGURATION.md for detailed configuration options.

---

🤖 Available Models

Model	Description	Best For
kimi-k2	Kimi K2 (default)	General coding, analysis, and automation

Note: Moonshot AI periodically updates available models. Run wopr providers models kimi for the latest list.

See docs/MODELS.md for detailed model information and capabilities.

---

🔄 Session Resumption

One of the most powerful features is the ability to resume previous sessions.

How It Works

When you create a session, WOPR receives a unique session ID from Kimi:

wopr session create my-session --provider kimi
# Output: Session initialized with ID: sess_abc123xyz

Resuming a Session

# Resume using the session ID
wopr session resume my-session --session-id sess_abc123xyz

Or via the configuration resume option:

{
  "provider": "kimi",
  "model": "kimi-k2",
  "resume": "sess_abc123xyz"
}

The plugin emits a session_id in the response when a session is created, which you can store for later resumption.

Session Persistence

Sessions persist on Moonshot AI's servers for 30 days of inactivity. WOPR automatically:

• Stores session IDs securely
• Handles re-authentication when needed
• Cleans up expired session references

---

🚀 Usage Examples

Basic Code Generation

wopr session create coding-task --provider kimi
wopr prompt coding-task "Create a Python function to parse JSON with error handling"

With System Prompt

wopr prompt my-session "Review this code" \
  --system "You are a senior code reviewer. Focus on security and performance."

Image Analysis

wopr prompt my-session "Describe this image" \
  --images ./screenshot.png,./diagram.jpg

Note: Images are included in the prompt text as references. The Kimi model will process and analyze the images alongside your text prompt.

YOLO Mode (Auto-approve)

YOLO mode is enabled by default in this provider, allowing Kimi to make filesystem changes without requiring manual confirmation for each operation.

wopr session create auto-task --provider kimi
wopr prompt auto-task "Refactor the src/ directory to use TypeScript"

Note: YOLO mode is enabled by default for streamlined automation workflows. Use only in version-controlled environments where changes can be reviewed and reverted if needed.

---

📁 Example Configurations

Check the examples/ directory for complete configuration examples:

• examples/basic.json - Basic setup
• examples/yolo-mode.json - Automated workflows
• examples/multi-model.json - Multi-model orchestration

---

🔧 Troubleshooting

Common Issues

Kimi CLI not found

# Re-run the installation
wopr plugin reinstall wopr-plugin-provider-kimi

OAuth authentication failed

# Reset credentials and re-authenticate
wopr providers remove kimi
wopr providers auth kimi

Session resumption failed

• Sessions expire after 30 days of inactivity
• Check if the session ID is correct
• Some sessions may be invalidated server-side

See docs/TROUBLESHOOTING.md for comprehensive troubleshooting.

---

📚 Documentation

• 📖 Installation Guide - Detailed setup instructions
• ⚙️ Configuration Reference - All configuration options
• 🤖 Model Information - Available models and capabilities
• 🔧 Troubleshooting - Common issues and solutions

---

🏗️ Architecture

This plugin uses the @moonshot-ai/kimi-agent-sdk to interact with the Kimi AI service. Key components:

• KimiClient: Implements the WOPR ModelClient interface
• Session Management: Creates and manages Kimi sessions with automatic session ID tracking
• A2A/MCP Integration: Converts WOPR A2A server configs to Kimi MCP format
• Streaming: Real-time token streaming via async generators

---

🔧 Development

# Clone the repository
git clone https://github.com/TSavo/wopr-plugin-provider-kimi.git
cd wopr-plugin-provider-kimi

# Install dependencies
npm install

# Build
npm run build

Key Dependencies

• @moonshot-ai/kimi-agent-sdk - Official Kimi Agent SDK
• winston - Logging

---

🔗 WOPR Ecosystem

This plugin is part of the WOPR ecosystem:

Package	Description
wopr	Core WOPR CLI
wopr-plugin-router	Intelligent model routing
wopr-plugin-p2p	P2P session synchronization
wopr-plugin-webui	Web UI for WOPR

---

📄 License

MIT © TSavo

---

🤝 Contributing

Contributions welcome! Please read the WOPR Contributing Guide first.

---

📞 Support

• 🐛 Report Issues
• 💬 Discussions
• 📧 Contact: See WOPR repository

---