Cligr

A simple CLI tool for managing groups of concurrent processes.

Installation

npm install -g Cligri

Configuration

Create a .cligr.yml configuration file. Cligr looks for the config in:

1. User home directory (~/.cligr.yml) - checked first
2. Current directory (./.cligr.yml) - fallback

You can keep a global config in your home directory and override it per project.

Quick start:

cligr config  # Opens ~/.cligr.yml in your editor

This creates a config file with examples if it doesn't exist.

Example config:

tools:
  kubefwd:
    cmd: kubectl port-forward $1 $2:$3

groups:
  myapp:
    tool: kubefwd
    restart: yes
    items:
      - service1,8080,80
      - service2,8081,80

Syntax:

• Items are comma-separated: "name,arg2,arg3"
• $1 = name (first value)
• $2, $3... = additional arguments
• If no tool specified, executes directly

Usage

cligr config              # Open config file in editor
cligr up <group>          # Start all processes in group
cligr ls <group>          # List group items
cligr down <group>        # Stop group (Ctrl+C also works)
cligr groups              # List all groups
cligr groups -v           # List groups with details

Restart Policies

• yes - Always restart on exit
• no - Never restart
• unless-stopped - Restart unless killed by cligr