feat(kimi): add Kimi Code CLI integration support
Add complete support for Kimi Code CLI agent format. - Add convert_kimi() function to generate YAML agent specs - Add install_kimi() function to install agents to ~/.config/kimi/agents/ - Add Kimi to tool detection and installer UI - Add integrations/kimi/ directory (generated files gitignored) - Update integrations/README.md with Kimi documentation - Add generated agent directories to .gitignore Users can generate agents with: ./scripts/convert.sh --tool kimi
This commit is contained in:
108
integrations/kimi/README.md
Normal file
108
integrations/kimi/README.md
Normal file
@@ -0,0 +1,108 @@
|
||||
# Kimi Code CLI Integration
|
||||
|
||||
Converts all Agency agents into Kimi Code CLI agent specifications. Each agent
|
||||
becomes a directory containing `agent.yaml` (agent spec) and `system.md` (system
|
||||
prompt).
|
||||
|
||||
## Installation
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- [Kimi Code CLI](https://github.com/MoonshotAI/kimi-cli) installed
|
||||
|
||||
### Install
|
||||
|
||||
```bash
|
||||
# Generate integration files (required on fresh clone)
|
||||
./scripts/convert.sh --tool kimi
|
||||
|
||||
# Install agents
|
||||
./scripts/install.sh --tool kimi
|
||||
```
|
||||
|
||||
This copies agents to `~/.config/kimi/agents/`.
|
||||
|
||||
## Usage
|
||||
|
||||
### Activate an Agent
|
||||
|
||||
Use the `--agent-file` flag to load a specific agent:
|
||||
|
||||
```bash
|
||||
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml
|
||||
```
|
||||
|
||||
### In a Project
|
||||
|
||||
```bash
|
||||
cd /your/project
|
||||
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
|
||||
--work-dir /your/project \
|
||||
"Review this React component for performance issues"
|
||||
```
|
||||
|
||||
### List Installed Agents
|
||||
|
||||
```bash
|
||||
ls ~/.config/kimi/agents/
|
||||
```
|
||||
|
||||
## Agent Structure
|
||||
|
||||
Each agent directory contains:
|
||||
|
||||
```
|
||||
~/.config/kimi/agents/frontend-developer/
|
||||
├── agent.yaml # Agent specification (tools, subagents)
|
||||
└── system.md # System prompt with personality and instructions
|
||||
```
|
||||
|
||||
### agent.yaml format
|
||||
|
||||
```yaml
|
||||
version: 1
|
||||
agent:
|
||||
name: frontend-developer
|
||||
extend: default # Inherits from Kimi's built-in default agent
|
||||
system_prompt_path: ./system.md
|
||||
tools:
|
||||
- "kimi_cli.tools.shell:Shell"
|
||||
- "kimi_cli.tools.file:ReadFile"
|
||||
# ... all default tools
|
||||
```
|
||||
|
||||
## Regenerate
|
||||
|
||||
After modifying source agents:
|
||||
|
||||
```bash
|
||||
./scripts/convert.sh --tool kimi
|
||||
./scripts/install.sh --tool kimi
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Agent file not found
|
||||
|
||||
Ensure you've run `convert.sh` before `install.sh`:
|
||||
|
||||
```bash
|
||||
./scripts/convert.sh --tool kimi
|
||||
```
|
||||
|
||||
### Kimi CLI not detected
|
||||
|
||||
Make sure `kimi` is in your PATH:
|
||||
|
||||
```bash
|
||||
which kimi
|
||||
kimi --version
|
||||
```
|
||||
|
||||
### Invalid YAML
|
||||
|
||||
Validate the generated files:
|
||||
|
||||
```bash
|
||||
python3 -c "import yaml; yaml.safe_load(open('integrations/kimi/frontend-developer/agent.yaml'))"
|
||||
```
|
||||
Reference in New Issue
Block a user