Commands
qprobe start
Start a background process with ready detection and log capture.
qprobe start
Start a named background process. The CLI spawns the command, watches stdout for a ready pattern, and returns control once the process is up.
qprobe start <name> "<cmd>" [options]Flags
| Flag | Default | Description |
|---|---|---|
--ready "<pattern>" | — | String or regex in stdout that signals ready state |
--timeout <duration> | 60s | Max time to wait for ready pattern |
--port <number> | — | Port for health checks and auto baseUrl |
--env KEY=VAL | — | Environment variables (repeatable) |
--cwd <path> | . | Working directory |
Examples
# Start a database
qprobe start db "docker compose up postgres" --ready "ready to accept" --timeout 30s
# Start a dev server
qprobe start server "bun dev" --ready "ready on" --port 3000
# Start with env vars
qprobe start server "bun dev" --ready "ready on" --port 3000 --env DATABASE_URL=postgresql://localhost/devBehavior
- Spawns a detached child process
- Pipes stdout/stderr to
tmp/qprobe/logs/<name>.log(timestamped, level-parsed) - Monitors stdout for
--readypattern match - Returns when ready or exits with code
2on timeout - Saves PID to
tmp/qprobe/pids/<name>.pid - Process survives between CLI calls (daemon pattern)