Skip to content
This repository was archived by the owner on Feb 25, 2026. It is now read-only.

docs: add MCP config file path (~/.config/kilo/opencode.json)#319

Merged
marius-kilocode merged 2 commits intoKilo-Org:devfrom
JungHoonGhae:docs/mcp-config-path
Feb 16, 2026
Merged

docs: add MCP config file path (~/.config/kilo/opencode.json)#319
marius-kilocode merged 2 commits intoKilo-Org:devfrom
JungHoonGhae:docs/mcp-config-path

Conversation

@JungHoonGhae
Copy link
Contributor

@JungHoonGhae JungHoonGhae commented Feb 16, 2026

Context

Users who install Kilo CLI via npm install -g @kilocode/cli (1.0.x) need the config file path and format for MCP. This PR documents ~/.config/kilo/opencode.json (or opencode.jsonc) and the "mcp" object format.

Implementation

  • README.md: After the migration table, add paragraph: MCP in ~/.config/kilo/opencode.json (or opencode.jsonc), top-level "mcp", type: "local", command: ["executable", ...], optional environment, enabled, timeout. Link to global/index.ts and config.ts (McpLocal).
  • packages/opencode/src/kilocode/docs/migration.md: In MCP Migration, add "Config file location" — CLI merges config.json, opencode.json, opencode.jsonc in ~/.config/kilo/; paths for macOS/Linux/Windows; pointer to Config.McpLocal.

Docs only.

Screenshots

before after
No path for MCP config README and migration.md state path and format

How to Test

  1. Install Kilo CLI 1.0.x, create or edit ~/.config/kilo/opencode.json, add "mcp": { "myserver": { "type": "local", "command": ["node", "/path/to/server.js"] } }.
  2. Restart CLI; status bar should show MCP count.
  3. Confirm README and migration doc match.

- README: state where MCP is configured and format (mcp object, type local, command array)
- migration.md: add config file location section for macOS/Linux/Windows and format
- README: mention opencode.jsonc; optional fields (environment, enabled, timeout); link to global/index.ts and config.ts McpLocal
- migration.md: document config load order (config.json, opencode.json, opencode.jsonc); Windows note (xdg-basedir); Config.McpLocal and file refs
@marius-kilocode marius-kilocode enabled auto-merge (squash) February 16, 2026 08:39
@marius-kilocode marius-kilocode merged commit 1f2ee7d into Kilo-Org:dev Feb 16, 2026
11 checks passed
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants