CLI Options

Usage

npx claude-view

Or if globally installed:

claude-view

The server starts, opens your browser, and begins discovering Claude Code sessions automatically.

Subcommands

Subcommand	Description
cleanup	Remove stale lock files and temporary data

claude-view cleanup

Environment variables

Variable	Description	Default
CLAUDE_VIEW_PORT	Override server port	47892
PORT	Alternative port variable (fallback)	—
RUST_LOG	Log level filter	warn

Examples

# Default — starts server and opens browser
npx claude-view

# Custom port via env var
CLAUDE_VIEW_PORT=8080 npx claude-view

# Verbose logging
RUST_LOG=info npx claude-view

# Debug logging for the server crate only
RUST_LOG=warn,claude_view_server=debug npx claude-view

# Clean up stale data
npx claude-view cleanup

Port fallback

If the specified port (default 47892) is unavailable, claude-view automatically binds to an ephemeral port and prints the actual URL. Logs show the actual address on startup.