---
title: log
description: View recent attestation receipts.
---

## treeship log

List recent receipts from the local store.

```bash
treeship log
treeship log --tail 20
```

Output:

```
  2026-03-30T14:22:01  [action]      art_a1b2c3d4e5
  2026-03-30T14:22:03  [decision]    art_d4e5f6a7b8
  2026-03-30T14:22:05  [approval]    art_g7h8i9j0k1
```

Each line shows the timestamp, the artifact type as a badge, and a truncated artifact ID.

### Options

| Option | Description |
|--------|-------------|
| `--tail <N>` | Show the last N receipts (default: 20) |
| `--follow` | Stream new receipts as they arrive |

## treeship log --follow

Stream receipts in real time. Useful for monitoring agent activity during a session.

```bash
treeship log --follow
```

Press `Ctrl+C` to stop. Pairs well with `--format json` for piping into other tools:

```bash
treeship log --follow --format json | jq '.action'
```
