# Kumo Coding Agent

<img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/e11edc4a-fafc-4f79-b9f6-6fbdf424effd" />

A portable collection of context and skills that extends any LLM coding tool with deep knowledge of the Kumo ML platform. Works with **Claude Code**, **Codex**, **Cursor**, and any tool that reads markdown.

---

## Setup

### Prerequisites

- **kumoai**: `pip install kumoai` (needed for running predictions, not for the agent itself) - **GitHub CLI**: `brew install gh && gh auth login` (needed only for `/kumo-issue` and `/kumo-pr` commands)

---

### <img src="https://anthropic.gallerycdn.vsassets.io/extensions/anthropic/claude-code/2.1.98/1775762394471/Microsoft.VisualStudio.Services.Icons.Default" width="24" height="24" align="top"> Claude Code

**1. Add the agent to your project:**

```bash cd your-project git clone https://github.com/kumo-ai/kumo-coding-agent.git ```

**2. Tell Claude Code to read the agent:**

```bash echo 'Also read kumo-coding-agent/CLAUDE.md for Kumo agent capabilities.' >> CLAUDE.md ```

**3. Set up permissions (zero-prompt setup):**

```bash bash kumo-coding-agent/setup.sh ```

**4. Install slash commands (optional):**

```bash npx skills add kumo-ai/kumo-coding-agent --agent claude-code ```

This installs `/kumo-issue` and `/kumo-pr` for reporting bugs and contributing fixes.

**5. Start using it.** Ask questions in natural language:

``` "Predict which customers will churn in the next 30 days by running RFM on the SALT dataset" ```

---

### <img src="https://raw.githubusercontent.com/lobehub/lobe-icons/refs/heads/master/packages/static-png/dark/codex.png" width="24" height="24" align="top"> Codex

**1. Add the agent to your project:**

```bash cd your-project git clone https://github.com/kumo-ai/kumo-coding-agent.git ```

**2. Tell Codex to read the agent:**

```bash echo 'Also read kumo-coding-agent/CLAUDE.md for Kumo agent capabilities.' >> AGENTS.md ```

**3. Set up permissions (ze