Installation

Quick install (recommended)

curl -fsSL https://get.claudeview.ai/install.sh | sh

That’s it. Downloads a native binary (~10 MB) to ~/.claude-view/bin and adds it to your PATH. No Node.js needed.

Then run:

claude-view

npx (alternative)

If you prefer npm, you can also run:

npx claude-view

npx downloads the pre-built binary and starts the server. Requires Node.js 18+.

Claude Code plugin

If you use Claude Code, install the plugin for the best experience — it auto-starts the server, adds 8 MCP tools, and 3 skills:

claude plugin add @claude-view/plugin

After installing, every Claude Code session automatically starts the dashboard. No manual npx claude-view needed. See the plugin guide for details.

Requirements

Requirement	Version
macOS	12 (Monterey) or later
Node.js	18 or later
Claude Code	Latest

Linux: Supported in v2.1 (coming soon). Windows in v2.2.

What happens on first run

1. The installer downloads the pre-built claude-view binary for your platform (~10 MB)
2. Installs to ~/.claude-view/bin and adds it to your PATH
3. Run claude-view — it starts a local HTTP server on port 47892
4. Your default browser opens http://localhost:{DEFAULT_PORT}
5. claude-view scans for active Claude Code processes automatically

Configuration

Change the port

CLAUDE_VIEW_PORT=8080 npx claude-view

Or set permanently in your shell profile:

export CLAUDE_VIEW_PORT=8080

If port 47892 is unavailable, claude-view automatically falls back to an ephemeral port and prints the URL.

Persistent binary (faster startup)

npm install -g claude-view
claude-view

Global install skips the npx download step on subsequent runs.

Verify it’s running

Open http://localhost:{DEFAULT_PORT} in your browser. You should see the session browser. If Claude Code is running, your active sessions appear automatically.

Troubleshooting

“Port 47892 already in use” Another instance is running. Kill it with pkill claude-view or use a different port.

“No sessions found” Start a Claude Code session in another terminal: claude. Sessions appear within a few seconds.

Binary download fails Check your Node.js version: node --version. Requires v18+. If behind a proxy, set HTTPS_PROXY.