bgproclisted

# bgproc A CLI for managing background processes. All commands output JSON to stdout. ## When to Use Use bgproc when you need to: - Start a dev server or other long-running process in the background - Restart a process with the same command and working directory - Check if a process is running and what port it's listening on - View logs from a background process - Stop a background process ## Commands ```bash # Start a process bgproc start -n <name> -- <command...> bgproc start -n devserver -- npm run dev bgproc start -n devserver -t 300 -- npm run dev # auto-kill after 5 min # Start and wait for port (recommended for dev servers) bgproc start -n devserver -w -- npm run dev # wait for port, then exit bgproc start -n devserver -w 30 -- npm run dev # wait up to 30s for port # Force restart (kill existing process first) bgproc start -n devserver -f -w -- npm run dev # Restart with same command and cwd (kills if running) bgproc restart <name> bgproc restart <name> -w # wait for port after restart # Check status (returns JSON with pid, running state, port) bgproc status <name> # View logs bgproc logs <name> bgproc logs <name> --tail 50 bgproc logs <name> --errors # stderr only # List all processes bgproc list bgproc list --cwd # filter to current directory # Stop a process bgproc stop <name> bgproc stop <name> --force # SIGKILL # Clean up dead processes bgproc clean <name> bgproc clean --all ``` ## Workflow 1. Start a process and wait for port: `bgpr