Mikk
Guides

VS Code Extension

The Mikk VS Code extension brings codebase intelligence directly into your editor — module tree, impact analysis, AI context, and MCP integration.

The extension reads from mikk.lock.json

All extension features are powered by the pre-computed lock file. Run mikk init or mikk watch first to generate it.

Installation

Install from VS Code Marketplace

Search for "Mikk" in the Extensions panel, or install from the command line:

code --install-extension getmikk.mikk-vscode

Initialize Mikk in your project

cd my-project
mikk init

The extension activates automatically when it detects mikk.lock.json in the workspace root.

Connect to GitHub Copilot (optional)

Run the MCP server and add the connection in VS Code settings:

mikk mcp install --tool vscode

Features

Module Tree

Sidebar view showing all detected modules, their file counts, and public API surfaces.

Impact Analysis

Right-click any file → 'Show Impact' to see the full blast radius before editing.

AI Context

Generate a token-budgeted context payload for the current file or selection.

Contract Status

Status bar indicator showing current violation count. Click to see full validation output.

Function Peek

Hover any function call to see its signature, module, and callers inline.

MCP Integration

Connects Mikk's 18 MCP tools directly to GitHub Copilot Chat.

Commands

All commands are available via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Prop

Type

The extension adds two sidebar panels to the Explorer:

Module Tree

📦 MIKK MODULES
  ├── auth (12 files, 3 public API)
  │   ├── login
  │   ├── logout
  │   └── validateToken
  ├── payments (8 files, 2 public API)
  │   ├── createCharge
  │   └── refund
  └── api (24 files)

Contract Status

⚡ ARCHITECTURE CONTRACTS
  ✅ auth — 0 violations
  ✅ payments — 0 violations
  ❌ api — 1 violation
     api/routes.ts imports db directly (Rule: no-call["db"])

MCP Integration with Copilot

When mikk mcp install --tool vscode is run, the extension registers Mikk's MCP tools with GitHub Copilot Chat. You can then ask Copilot:

@mikk What breaks if I change src/auth/login.ts?
@mikk Build context for: "Add rate limiting to the API layer"
@mikk Validate the architecture before I start this refactor

This gives Copilot the same real architectural grounding as Claude Desktop — module boundaries, exact function locations, and constraint rules — directly in VS Code.

Building from Source

git clone https://github.com/getmikk/mesh
cd packages/vscode-extension
bun install
bun run compile

Then press F5 in VS Code to launch the extension in a development host window.

Was this page helpful?

On this page