@peektree/vite-plugin

Vite plugin for Peek — hot-swap branches without restarting your dev server.

Install

npm install -D @peektree/cli @peektree/vite-plugin

Setup

// vite.config.ts
import { defineConfig } from 'vite'
import peek from '@peektree/vite-plugin'

export default defineConfig({
  plugins: [peek()]
})

Options

peek({
  port: 24789,   // WebSocket port (default: 24789)
  banner: true   // Show status overlay (default: true)
})

How It Works

1. Plugin opens WebSocket on port 24789
2. When you run peek sw feature-auth, the dev server root changes
3. Browser receives HMR signal and hot-reloads
4. Status banner updates to show current branch

Switch takes ~87ms. No cold start. No stash.

Browser Overlay

When active, Peek shows a status bar in your app:

• Back: Return to main
• Copy Scope: Grab context for AI
• Status: HMR errors, switch confirmations

Links

• CLI commands
• Workflows

License

MIT