agent-config 0.4.0

# Kilo Code

ID: `kilocode` — `agent_config::by_id("kilocode")`

## Hooks

Not supported. Prompt-level integration only.

## Prompt instructions

### Project scope (`Scope::Local(<root>)`)

| | |
| --- | --- |
| File | `<root>/.kilo/rules/<tag>.md` |
| Mechanism | One markdown file per consumer |
| Format | Plain markdown |

`.kilo/rules` is Kilo's current rules layout (referenced from `kilo.jsonc`); the
legacy `.kilocode/rules` directory still works upstream but is no longer written
by this crate. Kilo Code can also read root-level `AGENTS.md`, but this crate
writes only the per-consumer rules directory above.

### User scope (`Scope::Global`)

Not supported in v0.1. Kilo's global rules live at `~/.kilo/rules/`.
Calling with `Scope::Global` returns `AgentConfigError::UnsupportedScope`.

## Instructions

Standalone instruction files installed via `InstructionSurface`. Uses
`InstructionPlacement::StandaloneFile` because Kilo Code already has a per-tag
rules directory; each instruction is one file in that directory, with no host
include needed.

| | |
| --- | --- |
| Instruction file | `<root>/.kilo/rules/<name>.md` |
| Mechanism | One file per instruction — no host file needed |
| Ledger | `<root>/.kilo/.agent-config-instructions.json` |
| Placement | `InstructionPlacement::StandaloneFile` |

## MCP servers

### User scope (`Scope::Global`)

| | |
| --- | --- |
| File | `~/.config/kilo/kilo.jsonc` |
| Format | JSONC |
| Key | `mcp` (object keyed by server name) |

### Project scope (`Scope::Local(<root>)`)

| | |
| --- | --- |
| File | `<root>/kilo.jsonc`, or existing `<root>/.kilo/kilo.jsonc` |
| Format | JSONC |
| Key | `mcp` (object keyed by server name) |

### Configuration

```jsonc
{
  "mcp": {
    "my-server": {
      "type": "local",
      "command": ["node", "/path/to/server.js"],
      "environment": {
        "API_KEY": "${API_KEY}"
      }
    }
  }
}
```

## Skills

| Scope | Path |
| --- | --- |
| User | `~/.kilo/skills/<name>/` |
| Project | `.kilo/skills/<name>/` |

Kilo Code also supports `.claude/skills` and `.agents/skills` compatibility
directories in the CLI. `agent-config` writes the native Kilo path.

## References

- <https://kilo.ai/docs/customize/agents-md>
- <https://kilo.ai/docs/customize/custom-rules>
- <https://kilo.ai/docs/automate/mcp/using-in-kilo-code>
- <https://kilo.ai/docs/customize/skills>

Accessed: 2026-06-21.