claude_runner 1.4.1

CLI for executing Claude Code via builder pattern; YAML schema constants for command registration
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

# CLI Parameter: --mode

Filter `clr ps` output by session execution mode. Sessions launched with `--print`
(or `-p`) are classified as `print`; all others are classified as `interactive`.

- **Type:** enum (`all` | `interactive` | `print`)
- **Default:** `all`
- **Command:** [`ps`](../command/06_ps.md)

```sh
clr ps --mode interactive    # show only interactive (TTY) sessions
clr ps --mode print          # show only print-mode (headless) sessions
clr ps --mode all            # show both (default behavior)
clr ps -m print              # short form
CLR_PS_MODE=interactive clr ps  # env-var equivalent
```

**Note:** Mode detection reads the NUL-delimited `/proc/{pid}/cmdline` arguments
for each Claude process. If the argument list contains `--print` or `-p`, the
session is classified as `print`; otherwise `interactive`. The detection examines
individual arguments (NUL-separated fields), not the joined cmdline string.

**Note:** Invalid values (anything other than `all`, `interactive`, `print`) cause
`clr ps` to exit 1 with an error message to stderr.

### Referenced Parameter Groups

| # | Group | Membership | Co-members |
|---|-------|------------|------------|
| 5 | [Session Listing](../param_group/05_session_listing.md) | Full | `--columns`, `--wide` |

### Referenced Commands

| # | Command | Default | Notes |
|---|---------|---------|-------|
| 6 | [`ps`](../command/06_ps.md) | `all` | Filters the active sessions table; queued table unaffected |

### Referenced User Stories

| # | User Story | Persona |
|---|------------|---------|
| 26 | [026_session_listing.md](../user_story/026_session_listing.md) | Developer / CI operator |