GitHub - adamarutyunov/launch: A convenient terminal process manager for local development

A terminal process manager for developers running multiple projects and services locally.

Run all your services with one command, watch their logs live, start and stop individually or all at once. Works with a single project or a whole workspace.

Features

One config file per project — just ask an agent to write a launch.yml file for your project, the syntax is given below; run launch from the workspace root and it scans subdirectories automatically;
Multi-project sidebar — services grouped by project, collapse/expand projects;
Live log streaming — per-process log pane, persists across restarts;
Process persistence — detach and reattach later with keeping the processes running, or exit and kill all;
Dependency ordering — start services in the right order, across multiple projects;
Health checks — holds dependents until a service is actually up;
Taskfile support — runs tasks from a Taskfile.yml alongside processes;

Install

curl -fsSL https://raw.githubusercontent.com/adamarutyunov/launch/main/install.sh | sh

Or install a specific version:

VERSION=v1.1.0 curl -fsSL https://raw.githubusercontent.com/adamarutyunov/launch/main/install.sh | sh

Usage

launch              # current directory
launch ~/projects   # discovers launch.yml in subdirectories

Config

Drop a launch.yml in your project directory, for example:

name: backend

processes:
  postgres:
    title: PostgreSQL
    command: docker run --rm -p 5432:5432 postgres:16
    auto_start: true
    ready_check:
      command: pg_isready -h 127.0.0.1
      interval: 2s
      retries: 15

  api:
    title: API Server
    command: go run ./cmd/api
    auto_start: true
    depends_on:
      - postgres

Full schema

Field	Default	Description
`name`	directory name	Project name shown in sidebar
`processes.<slug>.title`	—	Display name
`processes.<slug>.command`	—	Shell command (`sh -c`)
`processes.<slug>.auto_start`	`false`	Start on launch
`processes.<slug>.working_dir`	launch.yml dir	Working directory
`processes.<slug>.env`	—	Extra environment variables
`processes.<slug>.depends_on`	—	Slugs that must be running first
`processes.<slug>.ready_check.command`	—	Polled to detect readiness
`processes.<slug>.ready_check.interval`	`2s`	Time between retries
`processes.<slug>.ready_check.retries`	`30`	Max attempts

depends_on

depends_on:
  - postgres          # same project
  - shared:redis      # cross-project (project name : slug)

Taskfile integration

Drop a Taskfile.yml next to launch.yml and its tasks appear in the sidebar automatically.

Keybindings

Key	Action
`j` / `k` or `↑` / `↓`	Navigate
`enter`	Collapse/expand project
`s` / `space`	Start or stop selected
`r`	Restart selected
`A`	Start all
`S`	Stop all
`g` / `G`	Jump to top/bottom of logs
`ctrl+u` / `ctrl+d`	Page up/down in logs
`c`	Clear logs
`h`	Hide/show task in sidebar
`q`	Detach (processes keep running)
`Q` / `ctrl+c`	Kill all and exit

Run launch --embed to hide the logs pane and show only the control sidebar. In embed mode, ctrl+c is ignored by the app, so use Q to quit.

Contributing

Bug reports and pull requests are welcome at github.com/adamarutyunov/launch.

Made by Adam · @_adamci