proc-cli 2.0.1

Semantic CLI tool for process management. Target by port, PID, name or path.
Documentation
---
layout: page
title: proc freeze
description: "Pause processes with SIGSTOP."
permalink: /commands/freeze
---

Send SIGSTOP to pause processes. They remain in memory but stop executing. Asks for confirmation unless `--yes`. Not available on Windows, which has no SIGSTOP: it exits 4.

```bash
proc freeze node             # freeze the processes named node
proc freeze :3000            # freeze process on port 3000
proc freeze :3000 :8080 node # freeze multiple targets
```

Several targets are separate arguments. Comma-separated lists (`:3000,:8080`) still work but are deprecated.

## Options

| Flag | Short | Description |
|------|-------|-------------|
| `--yes` | `-y` | Skip confirmation |
| `--dry-run` | | Show what would be frozen |
| `--in [<dir>]` | `-i` | Filter by directory. Takes the next word as its directory unless it starts with `-` (bare `--in` is the current directory, `--in=DIR` is explicit) |
| `--by <name>` | `-b` | Filter by process name (the whole name, ignoring case) |
| `--cmd` | | Match name targets and `--by` as a substring of the process name or full command line (like `pkill -f`) |
| `--json` | `-j` | Output as JSON |
| `--verbose` | `-v` | Show extra details |

## Examples

```bash
# freeze all node processes
proc freeze node

# freeze process on a specific port
proc freeze :3000

# preview before freezing
proc freeze node --dry-run

# freeze processes in current project only
proc freeze node --in .

# freeze without confirmation
proc freeze :3000 --yes
```

## See also

[thaw](thaw) to resume frozen processes, [stop](stop) for graceful shutdown, [kill](kill) for immediate termination.