Skip to content

Repository files navigation

English | 中文

ProcHub

ProcHub is a cross-platform desktop application for process management, built with Wails, Go, and Vue 3 + TypeScript. It provides an intuitive interface to manage, monitor, and control background processes across Windows, macOS, and Linux.

Screenshot

Process Management Home

Process Management

Process List

Add, remove, start, stop, and restart processes with auto-start and restart policies, plus real-time monitoring of PID, restart count, and errors.

Add Process Edit Process Process Logs
Add Process Edit Process Process Logs

Advanced Settings & Environment Variables

Configure auto-start, restart policy, max retries, and custom environment variables when adding a process.

Advanced Settings Environment Variables
Advanced Settings Environment Variables

Settings Page

Theme, language, auto-start on boot, version update, and about are managed on the settings page.

Settings Page

Features

Process Management

  • Add/Remove Processes: Easily add new processes with customizable commands, arguments, and environment variables
  • Start/Stop/Restart: Full control over process lifecycle with graceful shutdown support
  • Auto-start: Configure processes to start automatically when the application launches
  • Restart Policies: Support for always, on_failure, and never restart policies
  • Process Monitoring: Real-time status monitoring with PID, restart count, and error tracking

Cross-Platform Support

  • Windows (amd64)
  • macOS (Intel and Apple Silicon)
  • Linux (amd64, arm64)

Auto-start on Boot

  • macOS: Uses LaunchAgent
  • Linux: Uses XDG Autostart
  • Windows: Uses Registry

Logging

  • Rolling log files with configurable retention
  • Real-time log streaming
  • Separate stdout/stderr capture

CLI

ProcHub ships with a command line interface in the same executable. Running the binary without a known subcommand starts the GUI as usual; passing a subcommand runs the CLI, which talks to the running app through a local control endpoint (port and token are published to auth.json in the data directory on startup).

# Create a `prochub` command pointing at the installed app (macOS)
make cli

prochub process list                       # list all processes
prochub process start <id>                 # start a process
prochub process stop <id>                  # stop a process
prochub process logs <id> --tail 200       # show the last 200 log lines
prochub process logs <id> --follow         # stream new log lines
prochub config get                         # show settings
prochub config set theme light|dark        # set the light/dark theme
prochub config set language zh|en          # set the UI language
prochub config set autostart on|off        # toggle auto-start on boot
prochub config set autostart-wsl on|off    # toggle auto-starting WSL on boot
prochub wsl status                         # show WSL runtime status
prochub wsl start                          # start WSL
prochub wsl stop                           # stop WSL
prochub wsl restart                        # restart WSL
prochub status                             # show app status
prochub version                            # show the version

Process log files are stored under the data directory (<dataDir>/<logDir>/<id>), so logs also works while the GUI is open.

autostart-wsl only controls whether WSL is started automatically at boot. It is independent from the app's own auto-start setting and does not affect the manual wsl start / wsl stop commands.

Build

Prerequisites

  • Go 1.23.0 or higher
  • Node.js 18+ and npm
  • Wails CLI

Development

# Install frontend dependencies
cd frontend && npm install && cd ..

# Install Go dependencies
go mod download

# Run in development mode
wails dev

Production Build

# Build for current platform
wails build

# The built application will be in build/bin directory

💬 Join the Community

Add friend with note "ProcHub"

WeChat Group QQ Group
WeChat Group QQ Group

License

This project is licensed under the Apache 2.0 License.

About

process managemer / 进程管理工具

Topics

Resources

Stars

12 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages