Warpcode

A from-scratch, local coding agent that lives in your sidebar. Chat with an AI that can read and edit files, run commands, and search your code — without any managed runtime or closed-source agent framework.

Warpcode uses the OpenAI-compatible API, so it works with any compatible model provider: OpenAI, DeepSeek, Moonshot, local vLLM/Ollama, and more. Your API key and settings live in a simple local .env file shared with the Warpcode CLI.

Features

• 💬 Chat in the sidebar — ask questions, get explanations, write code
• 🛠️ Real tools — read/write/edit files, list files, grep, glob, and run bash commands
• 🔒 Permission prompts — approve or deny each file edit and command before it runs
• 📜 Session history — browse, resume, rename, and delete past conversations
• ⚙️ Built-in settings page — configure model, base URL, API key, and appearance (font sizes, compact mode, timestamps) without touching config files
• 🧵 Chronological timeline — text and tool calls display in the order they actually happen
• 🎨 Follows your VS Code theme
• 🔓 Open source (MIT) — read and modify every part

Setup

1. Install the extension
2. Open the Warpcode sidebar (the Warpcode icon in the right-side sidebar)
3. Click the ⚙️ Settings button
4. Fill in:
   • Model — e.g. deepseek-chat, gpt-4o, your-model
   • Base URL — your OpenAI-compatible endpoint, e.g. https://api.deepseek.com/v1
   • API Key — your provider API key
5. Click Save and start chatting

Settings are saved to ~/.warpcode/.env, shared with the Warpcode CLI.

Usage

• Type a message and press Enter to send (Shift+Enter for a newline)
• Type / for slash commands:
  • /clear — clear the current conversation
  • /mode <name> — switch permission mode (default, acceptEdits, plan, bypassPermissions, dontAsk)
  • /help — show all commands
• Click + New to start a new session
• Click the 📜 History button to browse and resume past conversations
• File tools show an Open button to jump to the file; the bash tool shows a Terminal button for live output

Commands

• Warpcode: Open Chat — focus the sidebar
• Warpcode: Reload Session — restart the current session

Requirements

• VS Code 1.85 or newer
• An API key for an OpenAI-compatible model provider

Privacy

• Your code and conversations stay on your machine.
• API keys are stored locally in ~/.warpcode/.env, never sent anywhere except your configured model endpoint.
• No telemetry, no accounts, no cloud.

License

MIT