@peektree/cli

The command-line interface for Peek — instant branch switching without restarting your dev server.

Install

npm install -D @peektree/cli

Quick Start

peek s my-feature     # create session
# browser shows my-feature code

peek .                # back to main
peek -                # toggle (like cd -)

peek save             # merge to main
peek discard          # abandon

Commands

| Command | Description | |---------|-------------| | peek s <name> | Start new session | | peek save | Merge + cleanup | | peek discard | Abandon session | | peek sw <target> | Switch worktree | | peek . | Back to main | | peek - | Previous (toggle) | | peek ls | List worktrees | | peek recover | Restore discarded work | | peek doctor | Diagnose + fix |

Recovery

Changes are never lost. When you discard a session with uncommitted work:

peek discard -f auth-fix
# ⚠️ Changes stashed to .peek/stash/auth-fix.patch

peek recover
# Lists all recoverable stashes

peek recover --apply stash-xxx
# ✓ Restored 3 files, 127 lines

Configuration

PEEK_PORT=3000
PEEK_WORKTREE_DIR=/tmp/peek

Or ~/.config/peek/config.json:

{ "port": 3000, "worktreeDir": "/tmp/peek" }

Requires

• Git 2.20+
• Node 18+

Links

• Full command reference
• Workflows
• Error codes

License

MIT