peek

Any agent, any branch, one command.

$ peek start ui-review
🚀 Starting session: peek-ui-review
   ✓ Worktree created
   ✓ Dev server switched

$ peek save
💾 Saving work...
   ✓ Merged to main
   ✓ Worktree cleaned

Zero downtime. Zero checkout. Browser updates instantly.

No restart

Dev server stays running. HMR does the rest.

No checkout

Main branch untouched. Context preserved.

Agent ready

Built for Claude, Cursor, Aider—any AI agent.

The Problem

AI writes code faster than humans review it.

# Every agent review costs 2 minutes:
$ git stash
$ git checkout agent/feature-47
$ npm run dev
# ...wait for server...
# ...review changes...
$ git checkout main
$ npm run dev
$ git stash pop

# At 20 reviews/day = 40 minutes lost

Quickstart

Install

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

Configure

// vite.config.ts
import peek from '@ekarya0x/vite-plugin'

export default {
  plugins: [peek()]
}

// next.config.ts
import withPeek from '@ekarya0x/next-plugin'

export default withPeek()({
  // your config
})

Use

$ peek start ui-review   # start isolated session
$ peek scope            # copy context for agent
$ peek save             # merge when happy

Agent Workflow

The recommended flow for AI-assisted development.

🚀

1. Start Session

$ peek start ui-review

Creates isolated worktree at /tmp/peek/peek-ui-review

📋

2. Share Context

$ peek scope

Copies project structure to clipboard for your agent

👀

3. Review Live

Browser shows agent's changes in real-time

✅

4. Save or Discard

$ peek save      # merge to main
$ peek discard   # abandon changes

Multiple Agents

Run multiple agents simultaneously:

$ peek start ui-review    # /tmp/peek/peek-ui-review
$ peek start api-metrics  # /tmp/peek/peek-api-metrics
$ peek start design-pass  # /tmp/peek/peek-design-pass

$ peek ui-review          # switch to ui-review
$ peek api-metrics        # switch to api-metrics
$ peek .                  # back to main

CLI Reference

Agent Commands

peek start <name> Create agent session

peek save Merge work to main

peek discard Abandon changes

peek scope Copy context for agent

Navigation

peek <branch> Switch to worktree

peek . Back to main

peek - Previous worktree

peek list Show all worktrees

Worktree Management

peek create <branch> Create worktree

peek remove <path> Remove worktree

peek clean Remove all temp worktrees

Framework Support

Vite

Full integration with HMR support

import peek from '@ekarya0x/vite-plugin'

export default {
  plugins: [peek({
    port: 24789,
    banner: true
  })]
}

Next.js

Works with App Router and Pages Router

import withPeek from '@ekarya0x/next-plugin'

export default withPeek({
  port: 24789,
  banner: true
})({
  // your config
})

API

HTTP Endpoints

Your dev server exposes these endpoints:

GET /__peek Current state + worktrees

POST /__peek Switch worktree { path: string }

GET /__peek/scope Get context payload

WebSocket

Connect to ws://localhost:24789 for real-time updates:

const ws = new WebSocket('ws://localhost:24789')

ws.onmessage = (e) => {
  const data = JSON.parse(e.data)
  // { type: 'peek:switch', from: '...', to: '...' }
}

Contact

Have a feature request or found a bug? Drop us a line.

peek — contact