gokazi

Simple daemonless process (swaheli: task <> kazi) manager.

Works by comparing processes by arguments, cwd and executable path.

Installation

Installation

Homebrew (macOS / Linux)

brew install foomo/tap/gokazi

See the foomo/homebrew-tap repository.

Docker

docker run --rm foomo/gokazi:latest --help

Multi-arch images (amd64, arm64) are published to Docker Hub.

mise

mise use github:foomo/gokazi

or run directly:

mise x github:foomo/gokazi -- --help

See mise.jdx.dev.

Binary release

Download the archive for your OS/arch from the releases page and extract gokazi into your $PATH.

go install

go install github.com/foomo/gokazi/cmd/gokazi@latest

Requires Go 1.26+.

Usage

$ gokazi help
CLI process manager

Usage:
  gokazi [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  config      Print config
  help        Help about any command
  list        List tasks
  stop        Stop task by id
  version     Print version

Flags:
      --debug   enable debug logs
  -h, --help    help for gokazi

Use "gokazi [command] --help" for more information about a command.

Configuration

version: '1.0'

tasks:
  list:
    name: gokazi
    description: Own listing process
    path: $PWD/bin
    cwd: $PWD
    args: [list]
  list-debug:
    name: gokazi
    path: $PWD/bin
    cwd: $PWD
    args: [list, --debug]

How to Contribute

Contributions are welcome! Please read the contributing guide.

License

Distributed under MIT License, please see the license file within the code for more details.

Made with ♥ foomo by bestbytes