Skip to main content
Installation & Setup

Installation Guide

How to Install Mouse

Prerequisites

  • VS Code 1.85+
  • A 14-day free trial starts automatically, no account or credit card required

Install Mouse

  1. Open VS Code
  2. Go to Extensions (Ctrl+Shift+X on Windows, Cmd+Shift+X on Mac)
  3. Search for Mouse by HIC AI
  4. Click Install

From the Terminal

You can install Mouse directly from the command line:

code --install-extension hic-ai.mouse

This downloads and installs the latest version automatically from the VS Code Marketplace.

From VS Code Marketplace

You can also download the Mouse VSIX extension file directly from VS Code Marketplace. Then, install it using your code editor's CLI:

code --install-extension mouse-*.vsix

From Open VSX

Mouse is also available on Open VSX. Download the VSIX file and install it using your code editor's CLI:

# VS Code
code --install-extension mouse-*.vsix

# Cursor
cursor --install-extension mouse-*.vsix

# Kiro
kiro --install-extension mouse-*.vsix

Post-Installation Setup

  1. Initialize your workspace. Open the Command Palette (Ctrl+Shift+P on Windows, Cmd+Shift+P on Mac) and select Mouse: Initialize Workspace
  2. Select your coding assistant. Choose your AI assistant (e.g., GitHub Copilot, Claude Code) from the dropdown list. Mouse will automatically configure the correct MCP settings.
  3. Refresh your editor. Open the Command Palette again and select Developer: Reload Window, or restart your IDE.
  4. Start using Mouse! Mouse is now ready. Your AI coding assistant will automatically have access to Mouse's precision editing tools.

NOTE

For Claude Code / Claude CLI and GitHub Copilot extensions in VS Code, you may need to start the Mouse MCP server by clicking the Start button in the UI. Navigate to the MCP configuration file (.mcp.json for Claude, .vscode/mcp.json for GitHub Copilot), and click the Start button immediately above the hic_local block (on line 3 of the file if it is the only MCP server currently installed).