> ## Documentation Index
> Fetch the complete documentation index at: https://auto-sop.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Runtime Control

> Pause, resume, and integrate auto-sop status into your terminal

# Runtime Control

## pause

Temporarily disable capture and the learner. Hooks remain installed but stop recording. Useful when working on sensitive code or during large refactors where captures would be noisy.

```bash theme={null}
auto-sop pause [options]
```

### Options

| Option             | Description                               |
| ------------------ | ----------------------------------------- |
| `--project <path>` | Project root (default: current directory) |

### Example

```bash theme={null}
auto-sop pause
```

```
auto-sop paused for /Users/you/projects/my-app
Captures and learner disabled. Run 'auto-sop resume' to re-enable.
```

<Note>
  Pausing is project-scoped. Other projects continue capturing normally.
</Note>

***

## resume

Re-enable capture and the learner after pausing.

```bash theme={null}
auto-sop resume [options]
```

### Options

| Option             | Description                               |
| ------------------ | ----------------------------------------- |
| `--project <path>` | Project root (default: current directory) |

### Example

```bash theme={null}
auto-sop resume
```

```
auto-sop resumed for /Users/you/projects/my-app
Captures and learner re-enabled.
```

***

## statusline

Print `[sop:on]` or `[sop:off]` for terminal prompt integration. Designed to be embedded in your shell prompt (PS1/PROMPT) so you always know if auto-sop is active.

```bash theme={null}
auto-sop statusline [options]
```

### Options

| Option             | Description  |
| ------------------ | ------------ |
| `--project <path>` | Project root |

### Example

```bash theme={null}
auto-sop statusline
```

```
[sop:on]
```

### Shell Integration

Add to your `.zshrc` or `.bashrc`:

<CodeGroup>
  ```bash Zsh theme={null}
  # Add auto-sop status to your prompt
  PROMPT='$(auto-sop statusline 2>/dev/null) '$PROMPT
  ```

  ```bash Bash theme={null}
  # Add auto-sop status to your prompt
  PS1='$(auto-sop statusline 2>/dev/null) '$PS1
  ```
</CodeGroup>

This gives you a persistent visual indicator:

```
[sop:on] ~/projects/my-app $
```

<Tip>
  The `2>/dev/null` suppresses errors if auto-sop isn't installed in the current directory, keeping your prompt clean in non-auto-sop projects.
</Tip>

### Pause/Resume Workflow

A typical workflow when handling sensitive operations:

```bash theme={null}
# About to work on auth secrets
auto-sop pause

# ... do sensitive work ...

# Done, re-enable
auto-sop resume
```

Your terminal prompt updates automatically if you have statusline integrated:

```
[sop:off] ~/projects/my-app $ auto-sop resume
[sop:on] ~/projects/my-app $
```