Stop juggling terminal tabs. dpr is a terminal UI that lets you manage all your development services in one place — start, stop, monitor logs, and handle dependencies with ease.
This project was created using Claude Code and AI tools. Most of the code was generated by AI. Bugs, errors, and unexpected behavior are likely. Contributions, bug reports, and PRs are welcome! If you are sensitive to AI-generated code, please use with caution.
- Multi-service management — Run and monitor multiple services in a single terminal
- Smart dependencies — Services wait for their dependencies to be ready before starting
- Real-time logs — View logs with search, scroll, and fullscreen mode
- Vim-style navigation — Keyboard-first design; native terminal text selection for copy/paste
- Flexible configuration — YAML config with auto-start, colors, and custom commands
- Log persistence — Optionally save logs to files for debugging
brew install tx2z/tap/dev-process-runnernpm install -g @tx2z/dev-process-runnerDownload the latest binary for your platform from GitHub Releases:
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | dpr-macos-arm64 |
| macOS (Intel) | dpr-macos-x64 |
| Linux (x64) | dpr-linux-x64 |
| Linux (ARM64) | dpr-linux-arm64 |
| Windows (x64) | dpr-win-x64.exe |
After downloading, make it executable and move to your PATH:
chmod +x dpr-macos-arm64
sudo mv dpr-macos-arm64 /usr/local/bin/dprNote: Windows support is experimental. Process management and terminal rendering may have issues on Windows.
# Run with default config (./dpr.yaml)
dpr
# Run with custom config
dpr --config path/to/config.yaml
# Validate config without running
dpr --validate
# Show help
dpr --helpCreate a dpr.yaml file in your project root:
name: "My Project"columns: auto # or 1, 2, 3logs: true # enable log persistencelogsDir: ~/.dpr/logsservices:
- id: apiname: "API Server"dir: ./apistart: npm run devstop: npm run stop # optional graceful stop commandautostart: truecolor: greenreadyPattern: "listening on port"dependsOn: []
- id: webname: "Web Frontend"dir: ./webstart: npm run devautostart: truecolor: bluedependsOn:
- api| Option | Type | Default | Description |
|---|---|---|---|
name | string | null | Project name displayed in header |
columns | number | "auto" | "auto" | Number of columns for service panels |
logs | boolean | false | Enable log persistence for all services |
logsDir | string | "~/.dpr/logs" | Directory for log files |
| Option | Type | Default | Description |
|---|---|---|---|
id | string | (required) | Unique service identifier |
name | string | id | Display name for the service |
dir | string | "." | Working directory |
start | string | (required) | Start command |
stop | string | null | Graceful stop command |
autostart | boolean | false | Start automatically on launch |
color | string | (auto) | Panel border color |
logs | boolean | global.logs | Enable log persistence |
env | object | {} | Environment variables |
dependsOn | string[] | [] | Service dependencies |
readyPattern | string | null | Regex pattern to detect ready state |
readyDelay | number | 500 | Delay after first output before ready |
runOnce | boolean | false | For commands that start background services and exit (e.g., supabase start, docker-compose up -d) |
Available colors: green, blue, yellow, magenta, cyan, red
| Key | Action |
|---|---|
q / Ctrl+C | Quit application |
/ | Enter command mode |
? | Show help |
f | Enter search mode |
1-9 | Focus service panel by number |
Tab / Shift+Tab | Cycle through panels |
t | Toggle between grid and sidebar view |
Projects with more than 6 services always use the sidebar view; the
columnsoption is ignored in that case.
With more than 6 services (or after pressing t), dpr shows a sidebar listing every service and a main area with up to 4 log "windows" stacked full-width.
| Key | Action |
|---|---|
j / k / arrows | Move the sidebar selection |
Enter | Show the selected service as the only window |
w | Add/remove the selected service as a window (max 4) |
Tab / Shift+Tab | Switch the focused window |
[ / ] | Scroll the focused window up/down a page |
g / G | Scroll the focused window to top/bottom |
c | Close the focused window |
v | Stream mode — print this service's logs into native scrollback |
s / x / K / r / h | Service actions on the selected service |
Copying log lines: there are two ways to copy, depending on what you want:
- Drag inside a window (sidebar view): dpr captures the mouse and highlights the log lines you drag over within that window; releasing copies them to the clipboard (OSC 52). This is line-level and stays inside the window you started in — no bleeding into the sidebar.
vstream mode: prints the selected service's logs into the terminal's real scrollback (via ink's<Static>), exactly like a normal command's output — so you can select character-precise and copy anywhere with your terminal's own selection (Cmd+C). Pressq/Escto return.The
y/Yshortcuts still copy the visible / full log buffer via OSC 52 with no mouse at all.
When a panel is focused (highlighted border):
| Key | Action |
|---|---|
Enter | Enter action mode |
Escape | Unfocus panel |
j / Down Arrow | Scroll logs down |
k / Up Arrow | Scroll logs up |
g | Scroll to top |
G | Scroll to bottom |
When in action mode (green double border):
| Key | Action |
|---|---|
s | Start service |
x | Stop service (graceful) |
K | Kill service (force) |
Escape | Exit action mode |
Note: Action mode requires explicit activation with
Enterto prevent accidental service stops.
| Key | Action |
|---|---|
Enter | Execute command |
Escape | Cancel command |
Backspace | Delete character |
| Key | Action |
|---|---|
Tab / Down Arrow | Next match |
Shift+Tab / Up Arrow | Previous match |
Enter | Confirm search |
Escape | Cancel search |
| Command | Aliases | Description |
|---|---|---|
/start <service> | /s | Start a service |
/stop <service> | /x | Stop a service gracefully |
/kill <service> | /k | Force kill a service |
/restart <service> | /r | Restart a service |
/start-all | /sa | Start all services |
/stop-all | /xa | Stop all services |
/clear <service> | /c | Clear service logs |
/focus <service> | /f | Focus service panel |
/quit | /q | Stop all and exit |
/help | /h, /? | Show help |
Services can be referenced by number (1-6), ID, or name.
| State | Description |
|---|---|
| STOPPED | Service is not running |
| WAITING | Waiting for dependencies to become ready |
| STARTING | Service process has started |
| READY | Service is ready (matched readyPattern or delay elapsed) |
| STOPPING | Service is being stopped |
| CRASHED | Service exited unexpectedly |
Services can depend on other services using dependsOn. A service will wait until all its dependencies are in the READY state before starting.
Circular dependencies are detected and will cause validation to fail.
When logs: true is set (globally or per-service), logs are written to files in the configured logsDir. Each service gets its own log file named <service-id>.log.
Log format:
[2024-01-15T10:30:00.000Z] Server started on port 3000
[2024-01-15T10:30:01.000Z] [ERR] Warning: deprecated API used
# Clone and install
git clone https://github.com/tx2z/dpr.git
cd dpr
npm install
# Run in development mode
npm run dev
# Type checking
npm run typecheck
# Linting
npm run lint
# Run tests
npm test# Build
npm run build
# Run built version
node dist/index.jsMIT