Process Compose

https://f1bonacc1.github.io/process-compose
Admin
Process Compose is a simple and flexible scheduler and orchestrator to manage non-containerized...
Tokens:66,213
Snippets:633
Trust Score:8.3
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### API authentication with token examples

Source: https://f1bonacc1.github.io/process-compose/client

Shows how to start Process Compose with an API token using the `PC_API_TOKEN` environment variable or the `--token-file` CLI flag, and how to call the API with the token in the `X-PC-Token-Key` header. The token must be at least 20 characters long.

```bash
# Start Process Compose with the token
PC_API_TOKEN="my-super-secret-token-12345" process-compose up

# Start using a token file
process-compose --token-file /path/to/token.txt up

# Call the API using the token
curl -H "X-PC-Token-Key: my-super-secret-token-12345" http://localhost:8080/processes

```

--------------------------------

### Install process-compose with Go install

Source: https://f1bonacc1.github.io/process-compose/installation

Installs process-compose using Go install. Requires Golang to be installed. This will compile and install the binary.

```shell
go install github.com/f1bonacc1/process-compose@latest

```

--------------------------------

### Install fish completions for new sessions

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_completion_fish

Installs completions for every new fish session by writing the completion script to the fish completions directory. A new shell is required for the setup to take effect.

```fish
process-compose completion fish > ~/.config/fish/completions/process-compose.fish

```

--------------------------------

### Install process-compose with default install script

Source: https://f1bonacc1.github.io/process-compose/installation

Installs process-compose using the official install script. By default, it installs to the ./bin directory relative to the working directory. Useful for CI scenarios.

```shell
sh -c "$(curl --location https://raw.githubusercontent.com/F1bonacc1/process-compose/main/scripts/get-pc.sh)" -- -d

```

--------------------------------

### Install completions for every new session on Linux

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_completion_bash

Execute this command once to install bash completions for every new session on Linux. A new shell is required for the setup to take effect.

```bash
process-compose completion bash > /etc/bash_completion.d/process-compose

```

--------------------------------

### Start a process with process-compose process start

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_process_start

Starts a specified process by name. The [PROCESS] argument is required, and [flags] can be used to modify the command behavior.

```bash
process-compose process start [PROCESS] [flags]

```

--------------------------------

### process-compose namespace start command usage

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_namespace_start

Shows the basic usage of the 'process-compose namespace start' command. It takes a namespace as an argument and starts all processes in that namespace.

```bash
process-compose namespace start [namespace] [flags]

```

--------------------------------

### env_cmds system information example

Source: https://f1bonacc1.github.io/process-compose/configuration

Example env_cmds for system information: HOSTNAME and KERNEL_VERSION.

```yaml
env_cmds:
  HOSTNAME: "hostname"
  KERNEL_VERSION: "uname -r"

```

--------------------------------

### env_cmds resource information example

Source: https://f1bonacc1.github.io/process-compose/configuration

Example env_cmds for resource information: AVAILABLE_MEMORY and CPU_CORES.

```yaml
env_cmds:
  AVAILABLE_MEMORY: "free -m | awk '/Mem:/ {print $7}'"
  CPU_CORES: "nproc"

```

--------------------------------

### Options for process-compose namespace start

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_namespace_start

Lists the options available for the 'process-compose namespace start' command. Currently, only the help flag is available.

```bash
  -h, --help   help for start

```

--------------------------------

### env_cmds example configuration

Source: https://f1bonacc1.github.io/process-compose/configuration

Example env_cmds configuration populating DATE, OS_NAME, and UPTIME variables. Commands should complete within 2 seconds and output a single line.

```yaml
env_cmds:
  DATE: "date"
  OS_NAME: "awk -F= '/PRETTY/ {print $2}' /etc/os-release"
  UPTIME: "uptime -p"

```

--------------------------------

### Run example configuration with process-compose

Source: https://f1bonacc1.github.io/process-compose/mcp-server

Run the example configuration file with process-compose. The file is located at examples/mcp-example.yaml and demonstrates multiple tool types, resource endpoints, integration with regular processes, and configuration best practices.

```bash
process-compose -f examples/mcp-example.yaml

```

--------------------------------

### Install completions for every new session on macOS

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_completion_bash

Execute this command once to install bash completions for every new session on macOS. A new shell is required for the setup to take effect.

```bash
process-compose completion bash > $(brew --prefix)/etc/bash_completion.d/process-compose

```

--------------------------------

### .env File Example

Source: https://f1bonacc1.github.io/process-compose/configuration

Example .env file with variables that can be overridden by environment variables or .env values.

```plaintext
VERSION='1.2.3'
DB_USER='USERNAME'
DB_PASSWORD='VERY_STRONG_PASSWORD'
WAIT_SEC=60

```

--------------------------------

### Install zsh completions for every new session on Linux

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_completion_zsh

Writes the generated completion script to the first directory in fpath, making it available for all new zsh sessions on Linux. A new shell is required for the setup to take effect.

```bash
process-compose completion zsh > "${fpath[1]}/_process-compose"

```

--------------------------------

### .pc_env file example

Source: https://f1bonacc1.github.io/process-compose/configuration

Example .pc_env file with Process Compose specific environment variables. Place this file in the project directory to control local, user environment specific settings.

```plaintext
PC_DISABLE_TUI=1
PC_PORT_NUM=8080
PC_NO_SERVER=1

```

--------------------------------

### Install process-compose with Homebrew

Source: https://f1bonacc1.github.io/process-compose/installation

Installs process-compose via Homebrew on macOS and Linux.

```shell
brew install f1bonacc1/tap/process-compose

```

--------------------------------

### Process start command

Source: https://f1bonacc1.github.io/process-compose/client

Starts one of the available non-running processes using the `process-compose process start` command.

```bash
process-compose process start [PROCESS] #starts one of the available non running processes

```

--------------------------------

### Start a namespace with namespace start

Source: https://f1bonacc1.github.io/process-compose/configuration

Starts all processes in the specified namespace. Acts on every configured member, including processes not running and disabled ones.

```bash
process-compose namespace start <namespace_name>

```

--------------------------------

### process-compose.yaml with processes and dependency

Source: https://f1bonacc1.github.io/process-compose/launcher

Example process-compose.yaml with three processes and a dependency from process1 on process2. Used to demonstrate running a subset of processes.

```yaml
#process-compose.yaml
processes:
  process1:
    command: "echo 'Hi from Process1'"
    depends_on:
      process2:
        condition: process_completed_successfully
  process2:
    command: "echo 'Hi from Process2'"
  process3:
    command: "echo 'Hi from Process3'"

```

--------------------------------

### ASCII graph output example

Source: https://f1bonacc1.github.io/process-compose/graph

Example output of the `process-compose graph` command showing a dependency tree with statuses and conditions.

```text
Dependency Graph
└── frontend [Pending]
    └── api-server [Running] <process_healthy>
        ├── postgres [Running] <process_healthy>
        └── redis [Running] <process_healthy>
```

--------------------------------

### Install zsh completions for every new session on macOS

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_completion_zsh

Writes the generated completion script to the zsh site-functions directory using Homebrew's prefix, making it available for all new zsh sessions on macOS. A new shell is required for the setup to take effect.

```bash
process-compose completion zsh > $(brew --prefix)/share/zsh/site-functions/_process-compose

```

--------------------------------

### process-compose process start [PROCESS]

Source: https://f1bonacc1.github.io/process-compose/client

Starts one of the available non-running processes.

```APIDOC
## process-compose process start [PROCESS]

### Description
Starts one of the available non-running processes.

### Method
CLI

### Command
process-compose process start [PROCESS]

### Parameters
- **PROCESS** (string) - Required - Name of the process to start.

### Example
```
process-compose process start myproc
```

```

--------------------------------

### Start a subset of namespaces with -n

Source: https://f1bonacc1.github.io/process-compose/configuration

Starts only the processes in the selected namespaces. Processes in unselected namespaces are not started and are not visible in the TUI. Dependencies on processes in unselected namespaces are pruned, with a warning logged at startup.

```bash
process-compose -n ns1 -n ns3
# will start only ns1 and ns3. ns2 namespace won't run and won't be visible in the TUI

```

--------------------------------

### env_cmds time-based values example

Source: https://f1bonacc1.github.io/process-compose/configuration

Example env_cmds for time-based values: TIMESTAMP and DATE_ISO.

```yaml
env_cmds:
  TIMESTAMP: "date +%s"
  DATE_ISO: "date -u +%Y-%m-%dT%H:%M:%SZ"

```

--------------------------------

### Basic process-compose.yaml configuration

Source: https://f1bonacc1.github.io/process-compose

Defines a simple process named 'hello' that echoes a message. This is the minimal configuration required to start using Process Compose.

```yaml
version: "0.5"

processes:
  hello:
    command: echo 'Hello World from Process Compose'

```

--------------------------------

### Install process-compose with custom directory using -b flag

Source: https://f1bonacc1.github.io/process-compose/installation

Installs process-compose with a custom installation directory using the -b parameter. On Linux, common choices are ~/.local/bin and ~/bin for the current user or /usr/local/bin for all users. Note that on macOS and Windows, ~/.local/bin and ~/bin are not added to $PATH by default.

```shell
sh -c "$(curl --location https://raw.githubusercontent.com/F1bonacc1/process-compose/main/scripts/get-pc.sh)" -- -d -b ~/.local/bin

```

--------------------------------

### process-compose up command syntax

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_up

Starts all process compose processes, or only the specified processes and their dependencies when process names are passed as arguments.

```bash
process-compose up [PROCESS...] [flags]

```

--------------------------------

### Install Go dependencies with go mod tidy

Source: https://f1bonacc1.github.io/process-compose/contributing

Installs the Go module dependencies after cloning the repository.

```bash
go mod tidy

```

--------------------------------

### Windows cmd backend command example

Source: https://f1bonacc1.github.io/process-compose/configuration

Example of a process command for the Windows cmd backend. Note the quoting differences compared to bash/zsh.

```yaml
process1:
  command: "python -c print(str(40+2))"
  #note that the same command for bash/zsh would look like: "python -c 'print(str(40+2))'"

```

--------------------------------

### GET /processes

Source: https://f1bonacc1.github.io/process-compose/client

Lists all available processes. Requires authentication token if configured.

```APIDOC
## GET /processes

### Description
Lists all available processes.

### Method
GET

### Endpoint
/processes

### Authentication
Requires `X-PC-Token-Key` header if token is configured.

### Response
#### Success Response (200)
- **processes** (array) - List of processes

#### Response Example
{
  "processes": []
}

```

--------------------------------

### process-compose process get options

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_process_get

Lists the options available for the process get command, including the output format flag with supported values json and wide (default).

```bash
  -h, --help            help for get
  -o, --output string   Output format. One of: (json, wide (default))

```

--------------------------------

### CLI graph command examples

Source: https://f1bonacc1.github.io/process-compose/graph

Shows the `process-compose graph` command with default ASCII output, Mermaid format, and raw JSON/YAML data.

```bash
# Display a beautiful ASCII tree (default)
process-compose graph

# Export to Mermaid flowchart format
process-compose graph --format mermaid

# Get the raw graph data in JSON or YAML
process-compose graph --format json
process-compose graph --format yaml
```

--------------------------------

### Show recipe content

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_recipe_show

Displays the process-compose.yaml content of a locally installed recipe to stdout. Use the -s or --syntax-highlight flag to highlight the recipe YAML syntax.

```bash
process-compose recipe show [recipe-name] [flags]

```

--------------------------------

### Before escaping template syntax in command

Source: https://f1bonacc1.github.io/process-compose/configuration

Shows a command that contains Go template syntax that would be rendered. This is the before example for template escaping.

```yaml
processes:
  nginx:
    command: "docker run -d --rm -p80:80 --name nginx_test nginx"
    liveness_probe:
      exec:
        command: '[ $(docker inspect -f "{{.State.Running}}" nginx_test) = true ]'

```

--------------------------------

### PowerShell backend command example

Source: https://f1bonacc1.github.io/process-compose/configuration

Use this syntax to run PowerShell scripts with the powershell backend. Note that older versions may lack command1 && command2 functionality.

```yaml
process2:
  command: "powershell.exe ./test.ps1 arg1 arg2 argN"

```

--------------------------------

### process-compose info usage

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_info

Prints configuration info. The command takes no arguments.

```bash
process-compose info [flags]
```

--------------------------------

### process-compose namespace options

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_namespace

Lists the options available for the namespace command, including the help flag.

```bash
  -h, --help   help for namespace

```

--------------------------------

### Run all processes with process-compose up

Source: https://f1bonacc1.github.io/process-compose/launcher

Runs all processes in the configuration. The output shows the order of execution.

```bash
process-compose up # will run all the processes - equal to 'process-compose'

#output:
#Hi from Process3
#Hi from Process2
#Hi from Process1

```

--------------------------------

### Build the binary with make build

Source: https://f1bonacc1.github.io/process-compose/contributing

Builds the Process Compose binary using the Makefile.

```bash
make build

```

--------------------------------

### Start a namespace after an initial up

Source: https://f1bonacc1.github.io/process-compose/configuration

Starts a small surface initially with 'up', then starts additional processes in the 'admin' namespace from another terminal. Namespace operations act on every configured member, including processes not running and those marked disabled.

```bash
process-compose up customer-api
# in another terminal - starts admin-api and admin-ui, which were not part of the initial selection
process-compose namespace start admin

```

--------------------------------

### Run scheduled process on startup with run_on_start

Source: https://f1bonacc1.github.io/process-compose/scheduled-processes

Configure a scheduled process to run immediately on startup and then at the specified interval. Set run_on_start: true to override the default behavior of waiting for the first scheduled time.

```yaml
processes:
  health-check:
    command: "./check-health.sh"
    schedule:
      interval: "5m"
      run_on_start: true  # Run immediately, then every 5 minutes

```

--------------------------------

### Disable scheduled process until manual start with disabled

Source: https://f1bonacc1.github.io/process-compose/scheduled-processes

Prevent a scheduled process from starting automatically by setting disabled: true. The schedule remains paused until the process is manually started (via TUI F7, CLI, or REST API), after which it resumes.

```yaml
processes:
  manual-backup:
    command: "./backup.sh"
    disabled: true
    schedule:
      cron: "0 2 * * *"  # Only starts running after first manual start

```

--------------------------------

### Run process-compose with multiple files

Source: https://f1bonacc1.github.io/process-compose/merge

Command to deploy using the base and production override files, excluding the development override. Files are merged in the order specified.

```bash
$ process-compose -f process-compose.yml -f process-compose.prod.yml

```

--------------------------------

### Start Processes in Parallel

Source: https://f1bonacc1.github.io/process-compose/launcher

Defines two processes that run in parallel. The TUI key F3 can be used to start processes in parallel.

```yaml
processes:
  process1:
   description: This process will sleep for 2 seconds
    command: "sleep 2"
  process2:
   description: This process will sleep for 3 seconds
    command: "sleep 3"

```

--------------------------------

### run command options

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_run

Options for the run command, including config files, disabling .env loading, help, and skipping dependencies.

```bash
  -f, --config stringArray   path to config files to load (env: PC_CONFIG_FILES)
      --disable-dotenv       disable .env file loading (env: PC_DISABLE_DOTENV=1)
  -h, --help                 help for run
      --no-deps              don't start dependent processes

```

--------------------------------

### process-compose up options

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_up

Lists the options available for the 'process-compose up' command, including flags for configuration, detaching, environment files, namespaces, sorting, and TUI settings.

```bash
  -f, --config stringArray       path to config files to load (env: PC_CONFIG_FILES)
      --detach-on-success        detach the process-compose TUI after successful startup. Requires --detached-with-tui
  -D, --detached                 run process-compose in detached mode
      --detached-with-tui        run process-compose in detached mode with TUI
      --disable-dotenv           disable .env file loading (env: PC_DISABLE_DOTENV=1)
      --dry-run                  validate the config and exit
  -e, --env stringArray          path to env files to load (default [.env])
  -h, --help                     help for up
  -d, --hide-disabled            hide disabled processes (env: PC_HIDE_DISABLED_PROC)
      --keep-project             keep the project running even after all processes exit
      --logs-truncate            truncate process logs buffer on startup
  -n, --namespace stringArray    run only specified namespaces (default all, env: PC_NAMESPACES)
      --no-deps                  don't start dependent processes
      --no-watch                 disable file watching, ignoring all 'watch' configuration (env: PC_NO_WATCH)
      --recursive-metrics        collect metrics recursively (env: PC_RECURSIVE_METRICS)
  -r, --ref-rate duration        TUI refresh interval in seconds or as a Go duration string (e.g. 1s) (default 1)
  -R, --reverse                  sort in reverse order
      --shortcuts stringArray    paths to shortcut config files to load (env: PC_SHORTCUTS_FILES) (default [/home/<user>/.config/process-compose/shortcuts.yml])
      --slow-ref-rate duration   Slow(er) refresh interval for resources (CPU, RAM) in seconds or as a Go duration string (e.g. 1s). The value should be higher than --ref-rate (default 1)
  -S, --sort string              sort column name. legal values (case insensitive): [AGE, CPU, EXIT, HEALTH, MEM, NAME, NAMESPACE, PID, RESTARTS, STATUS] (default "NAME")
      --theme string             select process compose theme (default "Default")
  -t, --tui                      enable TUI (disable with -t=false) (env: PC_DISABLE_TUI) (default true)

```

--------------------------------

### Help flag for namespace list

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_namespace_list

Shows help for the list command.

```bash
  -h, --help   help for list

```

--------------------------------

### process-compose process get command syntax

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_process_get

Displays the usage syntax for the process-compose process get command, which retrieves the state of a specified process.

```bash
process-compose process get [PROCESS] [flags]

```

--------------------------------

### Create personal automation hub with MCP tools and resources

Source: https://f1bonacc1.github.io/process-compose/blog/embedded-mcp-server-support-in-process-compose-v1940

Defines three personal automation processes as MCP tools and resources. `backup-photos` and `organize-downloads` are tools (with `organize-downloads` taking a `folder` argument), while `check-disk-space` is a resource that reports disk usage, enabling AI to perform tasks like "backup my photos and let me know if I'm running low on disk space".

```yaml
processes:
  backup-photos:
    command: "rsync -av ~/Photos/ backup-server:/photos/ && echo '{"status": "success", "files_copied": '$(rsync -av --dry-run ~/Photos/ backup-server:/photos/ | grep -c 'uptodate')'}}'"
    mcp:
      type: tool

  organize-downloads:
    command: "python ~/scripts/organize_downloads.py @{folder} --output-format json"
    mcp:
      type: tool
      arguments:
        - name: folder
          type: string
          description: "Folder path to organize"

  check-disk-space:
    command: "df -h / | tail -1 | awk '{print "{\"filesystem\":\"" $1 "\",\"size\":\"" $2 "\",\"used\":\"" $3 "\",\"available\":\"" $4 "\",\"percent\":\"" $5 "\"}"}'"
    mcp:
      type: resource

```

--------------------------------

### Partial shortcuts.yaml override example

Source: https://f1bonacc1.github.io/process-compose/tui

Example of a partial shortcuts.yaml that changes only the quit shortcut to F3 and renames process_stop to Terminate. All other shortcuts remain at their defaults.

```yaml
# $XDG_CONFIG_HOME/process-compose/shortcuts.yaml
shortcuts:
  process_stop:
    description: Terminate
  quit:
    shortcut: F3

```

--------------------------------

### process-compose info options

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_info

The info command has only the help flag.

```bash
-h, --help   help for info
```

--------------------------------

### scale command options

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_process_scale

Lists the options available for the scale command, including the help flag.

```bash
  -h, --help   help for scale

```

--------------------------------

### Configure a foreground process with is_foreground

Source: https://f1bonacc1.github.io/process-compose/launcher

Defines a process that runs in the foreground, requiring a full TTY (e.g., vim, top, gdb -tui). Foreground processes must be started manually with F7, can be started multiple times, and are only available in TUI mode. In TUI Client mode, a local process is started instead.

```yaml
processes:
  vim:
    command: "vim process-compose.yaml"
    is_foreground: true

```

--------------------------------

### Run process-compose with -f flag

Source: https://f1bonacc1.github.io/process-compose/intro

Runs process-compose with a direct path to the configuration file. Alternatively, run `process-compose` from the directory containing the file.

```bash
process-compose -f /path/to/process-compose.yaml

```

--------------------------------

### Rebuild the video series with five commands

Source: https://f1bonacc1.github.io/process-compose/blog/a-ten-part-video-course-for-process-compose

Five commands that rebuild the video series from scratch: capture the TUI, convert ANSI to HTML, generate narration, build the deck, and render the final videos.

```bash
./scripts/capture-tui.sh          # drive the demo stack, capture the TUI
python3 scripts/ansi2html.py      # ANSI into embeddable HTML
python3 scripts/gen-audio.py      # narration, one clip per paragraph
python3 scripts/build-deck.py     # assemble the deck
python3 scripts/render-video.py   # deck into ten MP4s
```

--------------------------------

### Start processes by namespace with -n

Source: https://f1bonacc1.github.io/process-compose/configuration

Starts processes that belong to the selected namespace. A process is selected if the namespace is any of its namespaces. The same applies to namespace operations, e.g., 'process-compose namespace stop billing' stops 'database' even though it also belongs to 'auth'.

```bash
process-compose -n billing
# starts billing_api and database

process-compose -n auth
# starts auth_api and database

```

--------------------------------

### Logger Configuration YAML Example

Source: https://f1bonacc1.github.io/process-compose/logging

Example YAML configuration for the Process Compose logger. Shows how to set field order, disable JSON output, configure timestamp format, disable metadata, add timestamps, disable colors, and flush each line.

```yaml
log_configuration:
  fields_order: ["time", "level", "message"] # order of logging fields. The default is time, level, message
  disable_json: true                         # output as plain text. The default is false
  timestamp_format: "06-01-02 15:04:05.000"  # timestamp format. The default is RFC3339
  no_metadata: true                          # don't log process name and replica number
  add_timestamp: true                        # add timestamp to the logger. Default is false
  no_color: true                             # disable ANSII colors in the logger. Default is false
  flush_each_line: true                      # disable buffering and flush each line to the log file. Default is false
```

--------------------------------

### List namespaces with process-compose namespace list

Source: https://f1bonacc1.github.io/process-compose/cli/process-compose_namespace_list

Lists all available namespaces. The command accepts flags, including -h/--help for help.

```bash
process-compose namespace list [flags]

```

--------------------------------

### GET /graph

Source: https://f1bonacc1.github.io/process-compose/graph

Retrieves the process dependency graph as a recursive JSON structure via the REST API.

```APIDOC
## [GET] /graph

### Description
Retrieves the process dependency graph as a recursive JSON structure. Each entry in the `nodes` map represents a leaf process and its full dependency tree.

### Method
GET

### Endpoint
/graph

### Response
#### Success Response (200)
- **nodes** (object) - A map where each key is a process name and the value is the recursive dependency tree for that process.

#### Response Example
```json
{
  "nodes": {
    "frontend": {
      "name": "frontend",
      "status": "Pending",
      "dependencies": [
        {
          "name": "api-server",
          "status": "Running",
          "condition": "process_healthy",
          "dependencies": [
            {
              "name": "postgres",
              "status": "Running",
              "condition": "process_healthy"
            },
            {
              "name": "redis",
              "status": "Running",
              "condition": "process_healthy"
            }
          ]
        }
      ]
    }
  }
}
```
```

--------------------------------

### Disable TUI with -t=false flag

Source: https://f1bonacc1.github.io/process-compose/tui

Disables the TUI run mode by passing the -t=false flag when starting process-compose.

```bash
./process-compose -t=false

```

--------------------------------

### Attach TUI client

Source: https://f1bonacc1.github.io/process-compose/client

Runs a fully remote TUI mode when process-compose was started in headless mode (`-t=false`).

```bash
process-compose attach

```

--------------------------------

### process-compose process restart [PROCESS]

Source: https://f1bonacc1.github.io/process-compose/client

Restarts one of the available processes. Waits for the configured backoff seconds between stop and start.

```APIDOC
## process-compose process restart [PROCESS]

### Description
Restarts one of the available processes. Waits for the configured backoff seconds between stop and start.

### Method
CLI

### Command
process-compose process restart [PROCESS]

### Parameters
- **PROCESS** (string) - Required - Name of the process to restart.

### Example
```
process-compose process restart myproc
```

```
Tokens:
Raw