A polished local project and process manager for Windows (and cross-platform). RunDock keeps related services together, exposes logs and ports when needed, and retains the compatible
alterCLI for existing scripts.
Download the latest RunDock-x.x.x-windows-x64-setup.exe from Releases and run it.
RunDock is the product name; the compatible alter.exe command is added to your PATH automatically.
- No console window popups — processes run silently in the background (Windows)
- Auto-restart with exponential backoff on crash
- Watch mode — restart automatically on file changes
- Namespaces — group and bulk-control related processes
- Web dashboard — real-time process monitor at
http://localhost:2999/ - Live log streaming — tail logs in terminal or browser
- State persistence — save and restore your process list across reboots
- Ecosystem config — define all apps in one TOML or JSON file
- Full REST API — automate everything
- Single binary — no runtime dependencies
- Dashboard authentication — password-protect the web UI with Argon2id hashing, session tokens, and a PIN quick-unlock
- Telegram bot — control your processes from Telegram: list, start, stop, restart, tail logs, and receive crash/restart alerts
- AI assistant — multi-provider chat panel (Ollama, GitHub Models, Claude, OpenAI-compatible) with streaming responses and process-aware context
- Port Finder — scan all open TCP/UDP ports, see owning processes, and kill by PID from the dashboard
- Notifications — Slack, Discord, Microsoft Teams, and webhook alerts on crash, restart, cron events, and more
- Process enable/disable — exclude individual processes from Start All without removing them
- Terminal history — per-process command history persisted across sessions
- Sidebar namespace groups — active processes grouped by namespace with collapsible sections and bulk stop/restart
Requires Rust.
git clone https://github.com/damingishere-coder/RunDock
cd RunDock
cargo build --release
# Binary: target\release\alter.exe# Start the daemon
alter daemon start
# Start processes
alter start python -- -m http.server 8080
alter start node --name api -- server.js
alter start "go run main.go" --name backend --cwd C:\projects\api
# List processes
alter list
# Stream logs
alter logs api --follow
# Open web dashboard
alter web # → http://127.0.0.1:2999/RunDock is built with Windows as a first-class platform:
- Spawned processes use
CREATE_NO_WINDOW— no black console popups - Daemon runs completely hidden in the background
npm,yarn,npxand other.cmdscripts work directly- Terminal button opens Windows Terminal or
cmd.exein the process directory - Data stored in
%APPDATA%\alter-pm2\
# alter.config.toml
[[apps]]
name = "api"
script = "python"
args = ["-m", "uvicorn", "main:app", "--port", "8000"]
cwd = "C:\\projects\\api"
namespace = "web"
[apps.env]
PORT = "8000"
[[apps]]
name = "worker"
script = "node"
args = ["dist/worker.js"]
watch = true
namespace = "workers"
[apps.env]
NODE_ENV = "production"alter start alter.config.tomlFull documentation is in docs/:
| Document | Description |
|---|---|
| README | Full project overview and setup guide |
| CLI Reference | All commands, flags, and examples |
| API Reference | Full REST API documentation |
| Ecosystem Config | Config file format reference |
| Architecture | How RunDock works under the hood |
| Changelog | Version history |
MIT — see LICENSE for details.