Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Consoler

Keep long-running processes alive — simple, native, and independent.

Consoler is a lightweight desktop app for developers who need to run, monitor, and restart background processes without a terminal multiplexer, Docker, or a heavy orchestration tool. One window, one purpose.

Consoler screenshot showing the dark GUI with a process list

Features

  • Native macOS GUI — dark mode, draggable title bar, process list with live status
  • CLI tooconsoler run "npm run dev" from your terminal
  • Start / Stop / Restart — one click per process
  • Live logs — in-app log viewer with auto-scroll
  • Survives app restart — process list persists in ~/.consoler/state.json
  • Process reaper — automatically detects crashes and updates status
  • Zero config — install and go

Install

macOS (Homebrew)

brew install sdk-e/tap/consoler

pip

pip install consoler

From source

git clone https://github.com/sdk-e/consoler.git
cd consoler
pip install .

Usage

GUI

consoler gui

A dark‑mode window opens. Type a command (e.g. python server.py, npm run dev, node index.js), give it an optional name, and press Add. Start/Stop/Restart with one click. View live logs by pressing Logs.

CLI

# Start a process
consoler run "python -m http.server 8000" --name "File Server"

# List all tracked processes
consoler list

# Stop a process
consoler stop <process-id>

# Remove a process from tracking
consoler remove <process-id>

# Tail logs for a process
consoler logs <process-id>

# Restart all stopped/crashed processes
consoler resume

What it's not

Consoler is not a process manager for production, a Docker replacement, or a systemd alternative. It is a local dev tool — the thing you reach for when you want a GUI for & and a way to keep your server running while you edit code.

Data

All state and logs live in ~/.consoler/. Remove that directory to wipe everything.

License

MIT

About

Consoler - Simple process keeper with native macOS GUI and CLI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages