CLI Reference 💻

BrowserTrack provides a complete command-line interface for managing the daemon, tracked projects, and runtime errors.

⚡ Commands #

Daemon Management #

BASH

browsertrack start             # Start local daemon on http://127.0.0.1:7331
browsertrack start --verbose   # Start with verbose message logging
browsertrack stop              # Stop running daemon process
browsertrack status            # Check status and connected browser sessions

Project Registry #

BASH

browsertrack projects          # List all tracked projects
browsertrack project add <name> --origin <url> --path <path>

Incident & Log Inspection #

BASH

browsertrack errors            # List open runtime error incidents
browsertrack errors --project <name>
browsertrack clear             # Wipe stored logs, screenshots, and incidents

MCP Integration #

BASH

browsertrack mcp               # Start Model Context Protocol server over stdio (auto-boots singleton daemon if offline)
browsertrack mcp --no-daemon   # Start MCP server without auto-booting background daemon

⚡ Singleton Daemon Lifecycle: When starting browsertrack mcp, BrowserTrack automatically checks if the daemon is already running. If offline, it starts a single, persistent background daemon on http://127.0.0.1:7331. All IDE windows, workspaces, and sub-sessions share this single daemon without spawning duplicates or conflicting on ports.

📖 Documentation Commands (Docboot) #

To preview or build this documentation locally using Docboot :

BASH

npm run docs:dev     # Start live documentation server on http://localhost:3000
npm run docs:build   # Build static production documentation to dist-docs/
npm run docs:serve   # Preview production build locally