What's This Plugin

oh-my-kilocode-slim is an agent orchestration plugin for KiloCode. It includes a built-in team of specialized agents that can scout a codebase, look up fresh documentation, review architecture, handle UI work, and execute well-scoped implementation tasks under one chief.

The main idea is simple: instead of forcing one model to do everything, the plugin routes each part of the job to the agent best suited for it, balancing quality, speed and cost.

To explore the agents themselves, see Meet the Pantheon. For the full feature set, see Features & Workflows below.

What Users Say

“Task management went from 5/10 to 8-9/10 easily. The Chief sends Fixers and Explorers, and I can still talk and plan with the Chief in the same session. The experience feels way smoother now.”

- vipor_idk

“I ditched all my harnesses for this beta version of omk-slim and don't look back or miss anything. Great work and IMHO all in the right direction.”

- stephanschielke

“I love omk-slim, and can't imagine running kilo without it. I love that I can create a Frankenstein of models... Makes the setup such a beast.”

- Capital-One3039

“It has significantly improved my workflow... Now, it is working very smoothly, and I love it.”

- xenstar1

Quick Start

Copy and paste this prompt to your LLM agent (Claude Code, AmpCode, Cursor, etc.):

Install and configure oh-my-kilocode-slim: https://raw.githubusercontent.com/emngny/oh-my-kilocode-slim/refs/heads/main/README.md

Manual Installation

bunx @emngny/oh-my-kilocode-slim@latest install

Run from Master

Use this if you want the latest code, easier bug fixes, or a local setup for development and contributions:

git clone https://github.com/emngny/oh-my-kilocode-slim.git ~/repos/oh-my-kilocode-slim
cd ~/repos/oh-my-kilocode-slim
bun install
bun run build
bun dist/cli/index.js install

The installer adds the local repo path to the plugin array in ~/.config/kilo/kilo.json, so KiloCode loads the plugin from that folder. To update later:

cd ~/repos/oh-my-kilocode-slim
git pull
bun install
bun run build

Getting Started

The installer generates a clean, empty custom preset configuration where you manually define the models you want to use for each agent.

[!TIP] Tune the models and agents for your own workflow. The plugin is designed for deep flexibility and customization, allowing you to use different providers for different agents.

Then:

1. Log in to the providers you want to use if you haven't already:

   kilo auth login

2. Refresh and list the models KiloCode can see:

   kilo models --refresh

3. Open your plugin config at ~/.config/kilo/oh-my-kilocode-slim.json

4. Update the models you want for each agent in the custom preset configuration.

[!TIP] It's recommended to understand how background orchestration works. The Chief prompt contains the scheduler rules, specialist routing logic, and thresholds for when work should be assigned to background agents. You can always delegate manually by calling a subagent via: @agentName <task>

[!TIP] Because background agents are now the default workflow, it is highly recommended to enable and configure Multiplexer Integration. It automatically opens each agent in a dedicated Tmux, Zellij, or Herdr pane, so you can watch specialists work live while the Chief continues coordinating the session.

The default generated configuration contains the custom preset:

{
  "$schema": "https://unpkg.com/@emngny/oh-my-kilocode-slim@latest/oh-my-kilocode-slim.schema.json",
  "preset": "custom",
  "presets": {
    "custom": {
      "chief": { "model": "", "skills": ["*"], "mcps": ["*", "!context7"] },
      "oracle": { "model": "", "skills": ["simplify"], "mcps": [] },
      "librarian": { "model": "", "skills": [], "mcps": ["websearch", "context7", "gh_grep"] },
      "explorer": { "model": "", "skills": [], "mcps": [] },
      "designer": { "model": "", "skills": [], "mcps": [] },
      "fixer": { "model": "", "skills": [], "mcps": [] },
      "observer": { "model": "", "skills": [], "mcps": [] }
    }
  }
}

For Alternative Providers

To use custom providers or a mixed-provider setup, use Configuration for the full reference. If you want a ready-made starting point, check the Author's Preset and $30 Preset - the $30 preset is the best cheap setup.

✅ Verify Your Setup

After installation and authentication, verify all agents are configured and responding:

kilo

Then run:

ping all agents

If any agent fails to respond, check your provider authentication and config file.

What's New in V2

V2 turns oh-my-kilocode-slim into a scheduler-first multi-agent workflow system. The Chief stays focused on planning, delegation, reconciliation, and verification while specialists do the work in their own lanes.

• Background agents - the Chief now dispatches specialists as background tasks, tracks task/session IDs, waits for completion events, and reconciles results before continuing.
• Companion - an optional floating desktop window shows which agents are currently active, including parallel background specialists.
• Deepwork - a structured workflow for large, multi-file, risky, or phased coding work using persistent plan files and Oracle review gates.
• Reflect - reviews repeated work patterns and suggests reusable skills, agents, commands, config rules, prompt rules, or project playbooks.
• Worktrees - manages Git worktrees as isolated coding lanes with safety protocols for complex, risky, or parallel tasks.
• oh-my-kilocode-slim skill - a bundled configuration skill that helps tune models, prompts, custom agents, MCP access, presets, and plugin behavior safely.

Background Agents

V2 makes background specialists the default mental model: the Chief plans the work graph, launches the right agents, avoids overlapping write ownership, and waits for terminal task results before acting on them.

See Background Orchestration for the full scheduler model.

Delegation Mode

V2 lets you tune how aggressively the Chief delegates to specialist agents. The default is conservative — the Chief handles small conversational and mechanical edits directly, and only delegates when the task clearly needs a specialist lane. Opt into aggressive to have the Chief dispatch almost every non-trivial task to subagents, since most specialists run on free or cheap models while the Chief itself is the expensive one.

// ~/.config/kilo/oh-my-kilocode-slim.json
{
  "delegationMode": "aggressive"
}

See Configuration for the full option reference and trade-offs.

Companion

The optional Companion is a floating desktop status window for live agent activity. It shows the current session state and which agents are active, so background work is easier to follow at a glance.

During interactive install, the installer asks whether to enable Companion and defaults to no. For automation, enable it explicitly with:

bunx @emngny/oh-my-kilocode-slim@latest install --companion=yes

See Companion for configuration, positions, sizes, and install details.

Deepwork

Deepwork is for heavy coding sessions: broad refactors, multi-phase features, risky architecture changes, or work that needs a persistent plan. It creates a local markdown progress file, uses Oracle review gates, and keeps implementation phases structured.

Start it with:

/deepwork <heavy coding task>

See Skills for when to use it and how the workflow runs.

Reflect

Reflect helps the Chief learn from repeated workflow friction. It reviews recent work and existing assets, then recommends the smallest useful improvement: a skill, custom agent, command, config rule, prompt rule, MCP permission change, or project playbook. If there is not enough evidence, it should recommend creating nothing.

Use it directly with:

/reflect
/reflect release workflow and checks

Or with natural prompts like:

reflect on my recent workflows
find repeated work worth turning into reusable instructions

See Skills for the full workflow and guardrails.

Worktrees

Worktrees manages Git worktrees as safe, isolated coding lanes under .slim/worktrees/<slug>/. The Chief manages the lifecycle of these lanes, tracks state in .slim/worktrees.json, dispatches specialist agents inside them, and requires explicit confirmation before mutating git state.

See Skills for the safety protocol.

oh-my-kilocode-slim Skill

The bundled oh-my-kilocode-slim skill helps the Chief configure and improve the plugin itself. Use it for model tuning, custom agents, prompt overrides, skill/MCP permissions, presets, optional agents, background orchestration, and recurring workflow friction.

See Skills for examples and safety rules.

🏛️ Meet the Pantheon

01. Chief: The Embodiment Of Order

02. Explorer: The Eternal Wanderer

03. Oracle: The Guardian of Paths

04. Council: The Chorus of Minds

[!NOTE] Why doesn't Chief auto-call Council more often? This is intentional. Council runs multiple models at once, so automatic delegation is kept strict because it is usually the highest-cost path in the system. In practice, Council is meant to be used manually when you want it, for example: @council compare these two architectures.

05. Librarian: The Weaver of Knowledge

06. Designer: The Guardian of Aesthetics

07. Fixer: The Last Builder

Optional Agents

Observer: The Silent Witness

[!NOTE] Why a separate agent? If your Chief model is not multimodal, enable Observer to handle images, screenshots, PDFs, and other visual files. Observer gives the Chief a dedicated multimodal reader without forcing you to change your main reasoning model. Configure a vision-capable model for observer in your agent overrides. To disable it, add 'observer' to disabled_agents. The bundled kilo-go install preset configures it automatically because its GLM Chief is not multimodal.

Read-only visual analysis - interprets images, screenshots, PDFs, and diagrams. Returns structured observations to the chief without loading raw file bytes into the main context window.

• Images, screenshots, diagrams → read tool (native image support)

• PDFs and binary documents → read tool (text + structure extraction)

• Enabled by default — configure a vision-capable model for best results; installing with --preset=kilo-go automatically configures kilo-go/kimi-k2.6

📚 Documentation

Use this section as a map: start with installation, then jump to features, configuration, or example presets depending on what you need.

✨ Features & Workflows

| Doc | What it covers | |-----|----------------| | Council | Run multiple models in parallel and synthesize a single answer with @council | | Custom Agents | Define your own specialists with custom prompts, models, MCP access, and Chief delegation rules | | ACP Agents | Connect external ACP-compatible agents such as Claude Code ACP or Gemini ACP as delegatable subagents | | Multiplexer Integration | Watch agents work live in Tmux, Zellij, or Herdr panes | | Codemap | Generate hierarchical codemaps to understand large codebases faster | | Clonedeps | Clone selected dependency source into an ignored local workspace for inspection | | Worktrees | Use .slim/worktrees/ lanes for isolated parallel or risky coding work | | Preset Switching | Switch agent model presets at runtime with /preset | | Interview | Turn rough ideas into a structured markdown spec through a browser-based Q&A flow | | Companion | Floating window companion for parsing, help, and types |

⚙️ Config & Reference

| Doc | What it covers | |-----|----------------| | Installation Guide | Install the plugin, use CLI flags, reset config, and troubleshoot setup | | Configuration | Config file locations, JSONC support, prompt overrides, and full option reference | | Project Customization | Repository-specific custom agents, prompt overrides, per-agent skills, and precedence | | Background Orchestration | Scheduler-first chief model built around native background subagents | | Maintainer Guide | Issue triage rules, label meanings, support routing, and repo maintenance workflow | | Skills | Bundled skills such as simplify, codemap, clonedeps, deepwork, reflect, worktrees, and oh-my-kilocode-slim | | MCPs | websearch, context7, gh_grep, and how MCP permissions work per agent | | Tools | Built-in tool capabilities like webfetch, LSP tools, code search, and formatters |

💡 Presets

| Doc | What it covers | |-----|----------------| | Author's Preset | The author's daily mixed-provider setup | | $30 Preset | A budget mixed-provider setup for around $30/month | | KiloCode Go Preset | The bundled kilo-go preset generated by the installer |

📄 License

MIT