Loki Mode for VS Code
Multi-agent autonomous development powered by Claude Code, OpenAI Codex, and Google Gemini.
Features
Session Management
- Start autonomous development sessions from PRD files
- Choose between Claude Code, OpenAI Codex, or Google Gemini as your AI provider
- Pause, resume, and stop sessions at any time
- Inject human guidance during execution
Real-Time Task Tracking
- View all tasks grouped by status: In Progress, Pending, Completed
- Live progress updates with spinning indicators for active tasks
- Click tasks to see details and current progress
Status Bar Integration
- Always-visible status indicator in the VS Code status bar
- Shows current phase and task progress when running
- Quick access to actions via click menu
- View PRD file, provider, and current phase
- Track session duration in real-time
- See current task and overall progress
Installation
From VS Code Marketplace
- Open VS Code
- Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
- Search for "Loki Mode"
- Click Install
From VSIX File
- Download the
.vsix file from the releases page
- Open VS Code
- Go to Extensions
- Click the "..." menu and select "Install from VSIX..."
- Select the downloaded file
Requirements
- VS Code 1.80.0 or higher
- Node.js 18+ (for the backend server)
- One of the supported AI CLI tools:
- Claude Code CLI (
claude)
- OpenAI Codex CLI (
codex)
- Google Gemini CLI (
gemini)
Quick Start
Step 1: Start the Backend Server
The extension requires the Loki Mode server to be running first:
# Using Loki CLI (if installed via npm or Homebrew)
loki start
# Or from loki-mode source directory
./autonomy/run.sh
You should see: "Loki API server listening on http://localhost:9898"
Step 2: Use the Extension
- Open a project folder in VS Code
- Click the Loki Mode icon in the Activity Bar (sidebar)
- Select "Start Session"
- Choose your PRD file
- Select your AI provider (Claude recommended)
- Watch as Loki Mode autonomously develops your project
Commands
| Command |
Description |
Keyboard Shortcut |
Loki: Start Session |
Start a new autonomous development session |
- |
Loki: Stop Session |
Stop the current session |
- |
Loki: Pause Session |
Pause execution |
- |
Loki: Resume Session |
Resume a paused session |
- |
Loki: Show Status |
Display current session status |
- |
Loki: Inject Input |
Send human guidance to the AI |
- |
Loki: Refresh Tasks |
Refresh task and session data |
- |
Access all commands via:
- Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
- Status bar click menu
- Activity Bar panel context menus
Extension Settings
Configure Loki Mode in your VS Code settings:
| Setting |
Description |
Default |
loki.apiEndpoint |
Backend API server URL |
http://localhost:3456 |
loki.defaultProvider |
Default AI provider |
claude |
loki.autoRefresh |
Auto-refresh interval (ms) |
5000 |
loki.showNotifications |
Show progress notifications |
true |
Example Settings
{
"loki.apiEndpoint": "http://localhost:3456",
"loki.defaultProvider": "claude",
"loki.autoRefresh": 3000,
"loki.showNotifications": true
}
Providers
Claude Code (Recommended)
- Full feature support
- Parallel task execution
- Sub-agent spawning
- MCP integration
OpenAI Codex
- Degraded mode
- Sequential task execution
- No sub-agent support
Google Gemini
- Degraded mode
- Sequential task execution
- No sub-agent support
Views
Session Panel
Located in the Activity Bar, shows:
- Current session status
- PRD file path (click to open)
- Selected provider
- Current phase
- Task progress
- Session duration
- Action buttons (Pause/Resume/Stop)
Tasks Panel
Located below the Session panel, shows:
- Tasks grouped by status
- In Progress tasks (expanded by default)
- Pending tasks (expanded by default)
- Completed tasks (collapsed by default)
Status Bar
Located in the bottom status bar:
- Idle: Shows "Loki Mode" with rocket icon
- Running: Shows phase and progress with spinning icon
- Paused: Shows "Paused" with pause icon
- Error: Shows "Error" with error icon
Screenshots
[Screenshot: Session Panel]
[Screenshot: Tasks Panel]
[Screenshot: Status Bar Running]
[Screenshot: Provider Selection]
Troubleshooting
Session won't start
- Ensure the backend server is running at the configured endpoint
- Check that your AI CLI tool is installed and accessible
- Verify your PRD file is valid
Tasks not updating
- Click "Refresh Tasks" in the panel
- Check the Output panel for errors
- Verify API endpoint connectivity
Status bar not visible
- Right-click the status bar
- Ensure "Loki Mode" is checked
- Restart VS Code if needed
Backend Setup
This extension requires the Loki Mode backend server. To start it:
# Using npm
npm install -g loki-mode
loki server
# Using Docker
docker run -p 3456:3456 lokesh/loki-mode
# From source
cd autonomy && ./run.sh --server
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Run tests:
npm test
- Submit a pull request
License
MIT License - see LICENSE file for details.
Links
