---
title: argusctl logs
description: Read the Argus Ops audit log.
---

# argusctl logs



{/* AUTO-GENERATED by scripts/generate-cli-reference.mjs from `argusctl introspect --json`.
    Do not edit by hand. Regenerate with: pnpm generate:cli */}

> Generated from argusctl v0.1.0 on 2026-06-09. Run `argusctl introspect --json` for the machine-readable tree.

## `argusctl logs`

Read the Argus Ops audit log.

```bash
argusctl logs <subcommand>
```

### `argusctl logs tail`

Show the most-recent audit rows.

```bash
argusctl logs tail [options]
```

| Option                 | Description                                      |
| ---------------------- | ------------------------------------------------ |
| `--since <duration>`   | e.g. 5m, 1h, 1d, or an ISO-8601 timestamp        |
| `--actor <clerk-user>` | filter by actor\_clerk\_user                     |
| `--pat <id>`           | filter by pat\_id                                |
| `--route <template>`   | filter by route template (e.g. "GET /v1/tokens") |
| `-l, --limit <n>`      | max rows                                         |
| `--api <url>`          | API base URL                                     |
| `--token <pat>`        | PAT to use                                       |
| `--json`               | JSON output                                      |
| `--fields <list>`      | comma-separated fields to include                |

## Examples

```bash
argusctl logs tail --since 1h --actor user_ABC --json
```


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)