proc-cli 2.1.1

Semantic CLI tool for process management. Target by port, PID, name or path.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

---
layout: page
title: Install
description: "Install proc on macOS, Linux or Windows. One binary, no dependencies."
permalink: /install
---

The latest version is **{{ site.data.release.version }}** ([what's new](changelog)). Every method below installs the same single binary, called `proc`.

## macOS

With [Homebrew](https://brew.sh). The command adds the `yazeed/proc` tap for you.

```bash
brew install yazeed/proc/proc
```

Or with the install script, which downloads the release binary for your Mac:

```bash
curl -fsSL https://raw.githubusercontent.com/yazeed/proc-cli/main/install.sh | bash
```

## Linux

The install script works on any distribution, including Alpine and older releases such as Debian 10 and Ubuntu 20.04, because the binaries are static:

```bash
curl -fsSL https://raw.githubusercontent.com/yazeed/proc-cli/main/install.sh | bash
```

Homebrew on Linux works too: `brew install yazeed/proc/proc`.

## Windows

With [Scoop](https://scoop.sh):

```bash
scoop bucket add proc https://github.com/yazeed/scoop-bucket-proc
scoop install proc
```

## Any platform

### npm or bun

The package downloads the binary for your platform the first time you run `proc`, and checks its SHA-256 checksum.

```bash
npm install -g proc-cli
bun install -g proc-cli
```

### Cargo

From source with [Rust](https://rustup.rs), or as a pre-built binary with [cargo-binstall](https://github.com/cargo-bins/cargo-binstall):

```bash
cargo install proc-cli
cargo binstall proc-cli
```

### Nix

```bash
nix profile install github:yazeed/proc-cli    # with the man page and shell completions
nix run github:yazeed/proc-cli -- on :3000    # or run it once without installing
```

### Docker

`--pid=host` lets proc see the host's processes, and `--net=host` its ports (for `on :port`, `ports` and `free`).

```bash
docker run --rm -it --pid=host --net=host yazeed/proc-cli
```

## Check it works

```bash
proc --version
proc ports
```

## Teach your coding agent

The [agent skill](skill) teaches Claude Code, Codex, Cursor, Gemini CLI and others when to reach for proc:

```bash
npx skills add yazeed/proc-cli
```

## Shell completions

The Nix package installs the completions and the man page. With any other install method, add them yourself:

```bash
proc completions bash > /etc/bash_completion.d/proc          # bash
proc completions zsh > ~/.zsh/completions/_proc               # zsh
proc completions fish > ~/.config/fish/completions/proc.fish  # fish
```

## Man page

```bash
proc manpage | sudo tee /usr/local/share/man/man1/proc.1 > /dev/null
man proc
```