# Getting started

Clone PaneVibe, run one setup command, and open your first real agent CLI in a PTY.

Canonical: https://panevibe.com/docs/getting-started/
Source: https://github.com/brandonmlicea/panevibe

## Requirements

Install Node.js 20.10 or newer before you begin. Node 22 is recommended. The setup script detects your operating system and handles the remaining toolchain, including Rust when it is missing.

The packaged desktop app uses Tauri 2 on Windows, macOS, and Linux.

## Build from source

The setup script installs workspace dependencies, builds the shared packages, frontend, and Rust binary, prepares the browser engine, then performs a real MCP handshake before reporting success.

`Terminal`

```bash
git clone https://github.com/brandonmlicea/panevibe.git
cd panevibe
node scripts/setup.mjs
```

## Useful setup modes

- --no-install checks the machine without changing it.
- --debug produces a faster development build.
- --skip-browser leaves the browser engine untouched.
- The setup command is idempotent and safe to run again.

`Terminal`

```bash
node scripts/setup.mjs --no-install
node scripts/setup.mjs --debug
node scripts/setup.mjs --skip-browser
```

## Open your first pane

PaneVibe bundles no model vendor. Install the agent CLI you already use, open a workspace, and choose a pane type. A Codex pane launches the native Codex TUI; a default chat pane launches PANEVIBE_IDE_CLI, Claude Code, or your platform shell in that order.

`Agent CLIs`

```bash
npm i -g @anthropic-ai/claude-code
npm i -g @openai/codex
```