CLI Flags & Parameters
This reference covers the complete list of startup arguments and command options supported by the px0 executable.
Command Syntax
px0 [flags] [file, directory, or pull request URL]
If the argument is omitted, px0 opens the current working directory (.). You can pass a folder to browse an entire codebase, a single file to jump directly into it, or a GitHub pull request URL to enter review mode.
Complete Flags Reference
| Flag | Type | Default | Description |
|---|---|---|---|
-port <int> |
integer | 7777 |
Port to listen on. Passing 0 automatically picks a random free port. |
-host <string> |
string | 127.0.0.1 |
Network interface address to bind. Use 0.0.0.0 to expose px0 over local networks, Docker containers, or remote cloud VMs. |
-base-path <path> |
string | "/" |
Base URL path prefix to serve endpoints and assets from (e.g. /rev-123/). Also configurable in settings via server.basePath. |
-y, -yes |
boolean | false |
Legacy bypass flag (merged PRs now open automatically without confirmation). |
-no-open |
boolean | false |
Do not launch the default web browser automatically on startup. Useful for background execution or remote sessions. |
-no-lsp |
boolean | false |
Do not use language servers (such as gopls, rust-analyzer, or clangd), even if installed on $PATH. Falls back to the built-in regex outline and search. |
-no-git |
boolean | false |
Disable git repository awareness, branch detection, status badges, and diff overlays. |
-agent <harness> |
string | none |
Pin coding harness for in-app agent edits: claude, gemini, cursor-agent, agy, opencode, codex, aider, goose, or a custom command template containing {prompt}. |
-no-agent |
boolean | false |
Disable coding harness discovery and edit capabilities entirely. |
-no-color |
boolean | false |
Disable ANSI color codes in terminal startup output. |
-quiet |
boolean | false |
Suppress informational startup narration in the terminal. |
-verbose |
boolean | false |
Enable verbose logging including request timing, prompt payloads, and agent job IDs. |
-update |
boolean | false |
Check for, download, and install the latest available release of px0 directly into user space. |
-no-update |
boolean | false |
Do not auto-update px0 on startup. |
-v, -version |
boolean | false |
Print px0 version and exit. |
Examples
Reviewing a GitHub Pull Request Directly
# Open a GitHub pull request with merge-base diffs and live commenting
px0 https://github.com/owner/repo/pull/123
Reverse Proxy & Subpath Hosting
# Host behind a reverse proxy or PR review pod with a custom URL path prefix
px0 -base-path /rev-123/ -host 0.0.0.0 -port 7777 /path/to/project
Ephemeral Port and Headless Mode (Remote / Agent Workflow)
px0 -port 0 -no-open /path/to/project
Pinning an Agent Harness for the Session
# Pin Claude Code
px0 -agent claude /path/to/project
# Or pin Gemini CLI
px0 -agent gemini /path/to/project
# Or use a custom command template
px0 -agent 'my-agent --prompt {prompt}' /path/to/project
Disabling Agent Dispatch
px0 -no-agent /path/to/project
Exposing Across Local Network or Cloud VM
px0 -host 0.0.0.0 -port 7777 -no-open /path/to/project
Self-Update to Latest Release
px0 -update