# olef usage

Source: https://olef.dev/docs/reference/cli/usage

Generated from **Olef 3.0.2**. [All commands](https://olef.dev/docs/reference/commands) · [Capabilities and requirements](https://olef.dev/docs/reference/capabilities)

These entries describe available commands, not a sequence to run. Check prerequisites before changing app, device, or cloud state. Global options are listed in the [command catalog](https://olef.dev/docs/reference/commands#global-options).

## olef usage

Opt-in local usage log (verb + duration + error code per invocation; never argument values, never leaves this machine)

```bash
olef usage --help
```

Output: **json**.

### olef usage status

Is usage logging on, where does it write, how big is the log?

```bash
olef usage status --help
```

Output: **json**.

| Argument | Description |
| --- | --- |
| `--json` | Accepted for compatibility; output is always JSON. |

### olef usage enable

Turn usage logging on (writes `"usage_log": true` to the user config)

```bash
olef usage enable --help
```

Output: **json**.

| Argument | Description |
| --- | --- |
| `--json` | Accepted for compatibility; output is always JSON. |

### olef usage disable

Turn usage logging off

```bash
olef usage disable --help
```

Output: **json**.

| Argument | Description |
| --- | --- |
| `--json` | Accepted for compatibility; output is always JSON. |

### olef usage report

Aggregate the log: verb frequencies, error codes, durations

```bash
olef usage report --help
```

Output: **json**.

| Argument | Description |
| --- | --- |
| `--days <DAYS>` | Only include entries from the last N days Default: `30`. |
| `--json` | Accepted for compatibility; output is always JSON. |

### olef usage clear

Delete the usage log files

```bash
olef usage clear --help
```

Output: **json**.

| Argument | Description |
| --- | --- |
| `--json` | Accepted for compatibility; output is always JSON. |