Kimchi for VS Code
An agentic coding chat panel for VS Code, powered by the Kimchi harness. Kimchi runs the agent loop — model orchestration, tool use, and session management — and this extension brings that experience directly into your editor as a side panel.
Prerequisites
This extension relies on the Kimchi CLI to drive the agent loop. Install and authenticate it before using the extension:
➡️ Kimchi Coding — Getting Started
Quick install:
curl -fsSL https://github.com/getkimchi/kimchi/releases/latest/download/install.sh | bash
Then launch kimchi once to authenticate. The extension spawns the CLI in the background, so a working kimchi login is required.
What this extension is
Kimchi for VS Code uses the Kimchi harness for the agent loop — the same engine that powers the Kimchi terminal experience. The extension provides an alternative, editor-integrated UI: a pinned side panel, streaming output, multi-model switching, and tool approval, all without leaving VS Code.
Features
- Side panel chat — pinned to the activity bar, always available alongside your editor
- Editor-area chat — open Kimchi as a full editor tab via Kimchi: Open Chat in Editor, or make it the default with the
kimchi.chatLocation setting
- Streaming responses — real-time, token-by-token output
- Multi-model support — switch between models via the in-panel dropdown
- Permission mode switching — switch modes (e.g. yolo mode) without restarting a session
- Agentic tool use — the agent reads and writes files, runs commands, lists directories, and searches your workspace
- Tool approval — choose between auto, writes-only, or approve-all gating for tool calls
- Tabbed conversations — multiple concurrent conversations with persistence, rename, and delete
- File attachments — attach files or the current editor selection to a message
- File mentions — reference files inline with
@ mentions
- Choice prompts — when the agent needs clarification, it presents clickable options
- Markdown rendering — code blocks, tables, lists, task lists, headings, and horizontal rules
- Code block actions — copy or insert code directly into your active editor
Getting started
1. Install the extension
Install Kimchi from the VS Code Marketplace.
2. Install & authenticate the Kimchi CLI
Follow the Getting Started guide to install the CLI and log in.
The extension is configured via VS Code settings (Kimchi: Open Configuration opens them). You can optionally set the executable path and environment variables in .vscode/settings.json (workspace) or your user settings:
{
"kimchi.env": {
"KIMCHI_TAGS": "team:your-team",
"KIMCHI_PERMISSIONS": "default"
},
"kimchi.executablePath": "$HOME/.local/bin/kimchi"
}
Note: The ~/.config/kimchi/vscode/config.json file is deprecated but still read for backward compatibility. When both are present, VS Code settings take precedence. If the deprecated file exists, the extension shows a warning with a button to open it.
4. Start chatting
Open the Kimchi icon in the activity bar, start a new chat, and begin coding. The agent runs in your workspace with the tools and context of the Kimchi harness.
Commands
Open the Command Palette (Cmd/Ctrl+Shift+P) and search for Kimchi:
| Command |
Action |
| Kimchi: Focus Chat |
Focus the Kimchi chat (sidebar or editor, per kimchi.chatLocation) |
| Kimchi: Open Chat in Editor |
Open the chat as an editor tab |
| Kimchi: New Chat |
Start a new conversation |
| Kimchi: Open Chat List |
Show the conversation list |
| Kimchi: Open Configuration |
Open the Kimchi settings in VS Code |
| Kimchi: Attach File to Chat |
Attach a file from the Explorer or editor |
| Kimchi: Attach Selection to Chat |
Attach the active editor selection |
| Kimchi: Next Tab |
Switch to the next conversation tab |
| Kimchi: Previous Tab |
Switch to the previous conversation tab |
| Kimchi: Close All Tabs |
Close all open conversation tabs |
Keyboard shortcuts
| Shortcut |
Action |
Cmd/Ctrl+Shift+K |
New chat |
Ctrl+Tab |
Next conversation tab |
Ctrl+Shift+Tab |
Previous conversation tab |
Enter |
Send message; while the agent is working, queues it (steers instead when kimchi.composerGesture is "steer-on-enter") |
Shift+Enter |
New line |
Cmd+Enter / Ctrl+Enter |
Steer the agent with the current message (queues instead when kimchi.composerGesture is "steer-on-enter"). When idle, both Enter variants send |
Configuration reference
VS Code settings
| Setting |
Type |
Default |
Description |
kimchi.executablePath |
string |
"kimchi" |
Path to the kimchi executable (supports $HOME expansion). |
kimchi.args |
array |
[] |
Extra command line arguments for the Kimchi process. |
kimchi.env |
object |
{} |
Extra environment variables for the Kimchi process (e.g. KIMCHI_TAGS). |
kimchi.chatLocation |
string |
"sidebar" |
Where Kimchi opens when you focus the chat (focus command, attach file/selection). One of: "sidebar" (activity-bar sidebar view), "editor" (a full editor tab), "editorBeside" (an editor tab beside the current one). |
kimchi.composerGesture |
string |
"queue-on-enter" |
What Enter in the chat composer does while the agent is working; Cmd+Enter (macOS) / Ctrl+Enter (other platforms) always performs the other action. One of: "queue-on-enter" (Enter queues, modifier steers), "steer-on-enter" (Enter steers, modifier queues). When idle, both variants send. |
kimchi.notifyCliUpdate |
boolean |
true |
Show a notification when a new Kimchi CLI version is available. |
kimchi.configPath |
string |
"" |
Deprecated. Absolute path to the legacy Kimchi JSON config file, still read for backward compatibility. If empty, uses ~/.config/kimchi/vscode/config.json. Use the settings above instead. |
Example:
{
"kimchi.chatLocation": "editorBeside",
"kimchi.env": {
"KIMCHI_TAGS": "team:your-team"
}
}
You can also open the editor tab on demand with Kimchi: Open Chat in Editor, regardless of the setting, and drag the sidebar view to the panel area or secondary sidebar yourself.
Feedback & issues
License
See LICENSE for details.