Autohand Code for VS Code

Unleash any LLM raw power directly in your terminal. Search million-line codebases instantly. Turn hours-long workflows into a single command. Your tools. Your workflow. Your codebase, evolving at thought speed.

• Powerful intelligence: Use the latest Open-source models like Claude Sonnet, or connect to your own local LLMs with Ollama or Llama.cpp. Autohand supports any model with an API, so you can choose the best one for your needs.
• Works for you: Autohand Code autonomously explores your codebase, reads and writes code, and runs Terminal commands with your permission. New, friendlier interface that makes it easier than ever to get started
• Integrated with the editor: Autohand Code knows about your current file and text selection, and proposes changes directly inside your editor window we built this extension taking advantage of the native api supported by VS Code.
• Powerful agentic features: Like subagents, custom slash commands. You can configure directly into your VSCode settings panel.

🚀 Quick Start

1. Install Extension

Download from VSCode marketplace:

code --install-extension AutohandAI.vscode-autohand

Alternatively, you can install a specific version:

code --install-extension AutohandAI.vscode-autohand@0.1.0

2. Install Autohand CLI

Download and install autohand code cli:

Via npm:

npm i autohand-cli

Via curl (Mac/Linux):

curl -fsSL https://autohand.ai/install.sh | sh

Via PowerShell (Windows):

iwr -useb https://autohand.ai/install.ps1 | iex

3. Configure

Create your account and configure your extension.

✨ Key Features

🤖 AI-Powered Assistant

• Natural Language Chat: Conversational coding assistance
• Agentic Execution: Multi-step task automation
• Real-time Visualization: Watch AI tools execute in real-time
• Context Awareness: Understands your codebase structure

🔧 Smart Code Actions

• CodeLens: Refactor, test, document, and fix functions
• Quick Fixes: "Fix with Autohand" for diagnostics
• Inline Actions: Right-click menu for selected code
• Diff Preview: Review changes before applying

🔒 Security & Permissions

• Interactive Approval: Confirm risky operations
• Project Permissions: Local whitelist/blacklist control
• Multiple Auth: Autohand account or API keys
• Secure Storage: VS Code Secret integration

🌍 Multi-Language Support

• 15 Languages: Full localization support
• Auto-Detection: Uses your VS Code display language
• Easy Switching: Configure in settings

📋 Supported Languages

Language	Code	Language	Code
English	en	Japanese	ja
Chinese (Simplified)	zh-cn	Korean	ko
Chinese (Traditional)	zh-tw	Russian	ru
French	fr	Turkish	tr
German	de	Polish	pl
Italian	it	Czech	cs
Spanish	es	Hungarian	hu
Portuguese (Brazil)	pt-br

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    VS Code Extension                       │
├─────────────────────┬───────────────────────────────────────┤
│   Extension Host    │           Webview Panel               │
│   (RPC Client)      │     (Chat UI - HTML/CSS/TS)           │
│                     │                                        │
│ • CLI Manager       │ • Chat Interface                      │
│ • Auth Service      │ • Real-time Updates                   │
│ • Permission System │ • Session Management                  │
│ • Diff Provider     │ • Code Actions                       │
└─────────┬───────────┴───────────────────────────────────────┘
          │ JSON-RPC (stdio)
          ▼
┌─────────────────────────────────────────────────────────────┐
│                    Autohand CLI                            │
│                  (Agent Engine)                            │
│                                                             │
│ • Tool Execution   • LLM Integration   • State Management   │
│ • Permission Control   • Error Handling   • Logging       │
└─────────┬───────────────────────────────────────────────────┘
          │ API Calls
          ▼
┌─────────────────────────────────────────────────────────────┐
│                   LLM Provider                            │
│            (OpenRouter, OpenAI, Ollama, etc.)             │
└─────────────────────────────────────────────────────────────┘

📦 Installation

From VS Code Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Autohand"
4. Click "Install"

For Development

# Clone repository
git clone https://github.com/autohandai/code-cli.git
cd vscode-autohand

# Install dependencies
npm install

# Build and install extension
npm run go

🔧 Configuration

Basic Settings

Access via: File > Preferences > Settings > Autohand

Setting	Default	Description
autohand.cliPath	autohand	Path to Autohand CLI
autohand.provider	openrouter	LLM provider
autohand.model	anthropic/claude-sonnet-4	Model to use
autohand.permissionMode	interactive	Permission mode
autohand.showThinking	true	Show agent reasoning
autohand.autoScroll	true	Auto-scroll chat

Permission Modes

• Interactive: Prompts for approval (recommended)
• Unrestricted: Auto-approves all operations
• Restricted: Blocks risky operations

Project-Specific Permissions

Create .autohand/settings.local.json in your workspace:

{
  "permissions": {
    "whitelist": ["run_command:npm *", "read_file:*.ts", "edit_file:src/**"],
    "blacklist": ["run_command:rm -rf *", "edit_file:*.env"]
  },
  "version": 1
}

🎯 Usage

Opening Chat

• Activity Bar: Click Autohand icon
• Status Bar: Click Autohand item
• Keyboard: Cmd+Shift+A / Ctrl+Shift+A
• Command: Autohand: Open Chat

Common Tasks

Ask About Code

# Select code and right-click
# Choose "Ask Autohand About Selection"
# OR use shortcut: Cmd+Shift+E / Ctrl+Shift+E

Refactor Functions

# Hover over function to see CodeLens
# Click "Refactor with AI"

Quick Fixes

# See lightbulb on diagnostics
# Click "Fix with Autohand"

Multi-File Changes

# Request changes across files
# Use "Preview Changes" to review
# Selectively apply modifications

Keyboard Shortcuts

Shortcut	Command
Cmd+Shift+A / Ctrl+Shift+A	Open Chat
Cmd+Shift+E / Ctrl+Shift+E	Ask About Selection
Ctrl+Alt+I / Ctrl+Cmd+I	Ask in Chat
Ctrl+Shift+K / Cmd+Shift+K	Quick Actions

🔑 Authentication

Autohand Account (Recommended)

autohand login

• Device flow via browser
• Account management at https://autohand.ai
• Cross-device sync

API Key Configuration

// ~/.autohand/config.json
{
  "provider": "openrouter",
  "openrouter": {
    "apiKey": "your-key-here"
  }
}

Supported Providers:

• OpenRouter (default)
• OpenAI
• Ollama (local)
• Llama.cpp

🛠️ Development

Setup

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode (recommended)
npm run watch

# Run tests
npm test

# Package extension
npm run package

Scripts

Script	Description
npm run compile	Compile TypeScript
npm run watch	Watch mode for development
npm test	Run unit tests
npm run test:coverage	Run tests with coverage
npm run test:integration	Run integration tests
npm run package	Package extension
npm run go	Build, package, and install

Project Structure

vscode-autohand/
├── src/
│   ├── extension.ts          # Extension entry point
│   ├── core/
│   │   ├── cli-manager.ts    # CLI process lifecycle
│   │   ├── rpc-client.ts     # JSON-RPC communication
│   │   └── store.ts          # State management
│   ├── providers/
│   │   ├── chat-provider.ts  # Webview provider
│   │   └── chat-panel.ts     # Editor panel provider
│   ├── views/webview/        # Chat UI (HTML/CSS/TS)
│   └── types/                # TypeScript interfaces
├── l10n/                     # Localization files
├── docs/                     # Documentation
├── package.json              # Extension manifest
└── tsconfig.json             # TypeScript config

🐛 Troubleshooting

Quick Debug Checklist

1. Check CLI: which autohand or autohand --version
2. Check Logs: Output panel → "Autohand" channel
3. Enable Debug: Set autohand.debug: true
4. Verify Auth: autohand login or check config
5. Test Connection: Try a simple message

Common Issues

Extension Won't Activate

• Verify VS Code >= 1.85.0
• Check Output panel for errors
• Verify CLI installation: which autohand

CLI Connection Failed

• Check autohand.cliPath setting
• Test CLI: autohand --help
• Review ~/.autohand/config.json

Permission Issues

• Check autohand.permissionMode setting
• Review local permissions in .autohand/settings.local.json
• Check extension logs for permission decisions

Webview Problems

1. Open Developer Tools (Cmd+Shift+I in webview)
2. Check console for JavaScript errors
3. Look for CSP (Content Security Policy) errors
4. Verify network requests

API/Authentication Errors

• Verify API key configuration
• Check provider settings
• Test with: autohand login
• Review network timeout settings

Getting Help

1. Enable Debug Mode: autohand.debug: true
2. Check Logs: Output panel → "Autohand"
3. Update CLI: npm update -g autohand
4. Report Issues: GitHub with debug logs

🤝 Contributing

We welcome contributions! visit our code-cli repository for more details on how to contribute to this project. https://github.com/autohandai/code-cli

Development Workflow

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests: npm test
5. Submit a pull request

Code Style

• ESLint + Prettier configured
• TypeScript strict mode
• VS Code extension guidelines
• Conventional commits

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🌐 Links

• Homepage: https://github.com/autohandai/code-cli
• Issues: https://github.com/autohandai/code-cli/issues
• Discord: https://discord.gg/MWTNudaj8E
• Autohand CLI: https://github.com/autohand/cli
• Documentation: docs/

---

🎉 That's all folks! Happy coding with Autohand! 🚀