Skip to main content
← All buyer guides

Buyer guide · agentic harnesses

Migrating from Roo Code to Kilo Code

Roo Code’s discontinuation pushed many teams toward Kilo’s OpenCode-lineage stack. This guide covers Marketplace install, credential migration, project rules, and the VS Code vs JetBrains paths without assuming settings auto-port.

Who this is for: Teams migrating from Roo Code to Kilo Code on VS Code or JetBrains after Roo’s discontinuation — especially those with existing .roorules, provider keys, and terminal workflows to preserve.

What actually matters

  • Install from the official Marketplace path (kilocode.Kilo-Code on VS Code); JetBrains plugin feature depth may differ from Roo’s old surfaces.
  • API keys and provider auth do not auto-port — expect full re-authentication on every provider.
  • Kilo CLI tokens often live under ~/.local/share/kilo/, not ~/.config/kilo/ — check before debugging missing credentials.
  • Consolidate Roo project rules (.roorules, .cursorrules) into AGENTS.md as the single source of truth.
  • Verify test commands and file permissions on a disposable branch before trusting the first autonomous edit.
  • Optional @kilocode/cli extends terminal workflows — decide IDE-only vs IDE-plus-CLI before rollout.

ACE recommendation

Install Kilo from the official Marketplace path, re-authenticate every provider, consolidate rules into AGENTS.md, pilot on a sanitized repo, and read Kilo’s platform docs before assuming Roo parity.

Set up the shortlist

How to run this decision

  1. 01Uninstall or disable Roo Code; install Kilo from the VS Code Marketplace (kilocode.Kilo-Code) or JetBrains plugin store.
  2. 02Re-authenticate every provider in Kilo settings — do not assume Roo-stored keys transfer.
  3. 03If using Kilo CLI, confirm token location under ~/.local/share/kilo/ and update any scripts that referenced Roo paths.
  4. 04Merge .roorules and legacy .cursorrules content into AGENTS.md at the repo root; link or copy into Kilo’s rules format.
  5. 05Run the project test command manually, then ask Kilo to fix a trivial issue on a throwaway branch.
  6. 06Read Kilo’s platform docs for feature parity gaps vs Roo before committing team-wide.

Common pitfalls

  • Assuming settings and API keys migrate automatically — silent auth failures waste a full day.
  • Looking for CLI tokens in ~/.config/kilo/ when they are under ~/.local/share/kilo/.
  • Leaving conflicting .roorules and new Kilo rules — agents get contradictory instructions.
  • Skipping re-test of permissions on a branch that touches CI or production config.
  • Expecting JetBrains parity with VS Code without verifying feature list first.

Ask before you buy

  • Are you installing from the VS Code Marketplace (kilocode.Kilo-Code) or the JetBrains plugin — feature depth can differ from Roo’s old surfaces?
  • Do API keys and provider auth auto-port? Expect re-auth; Kilo CLI tokens often live under ~/.local/share/kilo/, not ~/.config/kilo/.
  • Where did Roo project rules live (.roorules, .cursorrules)? Map them into AGENTS.md and Kilo’s rules format as one source of truth.
  • Will you use the flagship IDE extension only, or also the optional @kilocode/cli for terminal workflows?
  • Did you verify the test command and permissions on a disposable branch before trusting the first autonomous edit?

More buyer guides

Related decisions

Other harness buyer guides that answer the next question after this one.