Skip to main content

# kater timeline read

An app's or a project's timeline, newest first, by Monday week.

{/* Written by apps/landing-page/scripts/docs/write_cli_reference.py from the kater CLI's own help and scripts/docs/cli-reference.md. Do not edit it by hand: change those, then run the script. */}

Each entry gives its id, kind, time, author and text, with its figures as pinned tags, and the replies under it. Quiet snapshots in a row and changes to the app's files in a row are folded. A project's timeline also holds its apps' and a row for each change to its settings. Only what you can read is listed.

## Examples

```bash
# An app's or a project's timeline, newest first, by Monday week
kater timeline read <id>
```

## Arguments

<div class="cli-options">

| Argument | Description |
| --- | --- |
| `<id>` | The app's or the project's id, such as app_129abe379bbf43b5a7012c252157e634 or prj_7c1e9a52d4b84f6e8a3d0b2c5f1e9d47. |

</div>

## Options

<div class="cli-options">

| Option | Description |
| --- | --- |
| `--entries <entries>` | decisions keeps decisions; snapshots keeps snapshots and readouts. It is `decisions` or `snapshots`. |
| `--since <since>` | Only what happened on or after this date, such as 2026-10-01. |

</div>

It also takes the [global options](https://kater.ai/docs/cli-reference/global-options/) `--json` and `--help`.

## See also

- [`kater timeline`](https://kater.ai/docs/cli-reference/timeline/)
- [All commands](https://kater.ai/docs/cli-reference/kater/)

On this page

Examples
Arguments
Options
See also

Kater CLI Projects and timelines timeline

kater timeline read

An app's or a project's timeline, newest first, by Monday week.

Each entry gives its id, kind, time, author and text, with its figures as pinned tags, and the replies under it. Quiet snapshots in a row and changes to the app’s files in a row are folded. A project’s timeline also holds its apps’ and a row for each change to its settings. Only what you can read is listed.

Examples

# An app's or a project's timeline, newest first, by Monday week
kater timeline read <id>

Arguments

Argument	Description
`<id>`	The app’s or the project’s id, such as app_129abe379bbf43b5a7012c252157e634 or prj_7c1e9a52d4b84f6e8a3d0b2c5f1e9d47.

Options

Option	Description
`--entries <entries>`	decisions keeps decisions; snapshots keeps snapshots and readouts. It is `decisions` or `snapshots`.
`--since <since>`	Only what happened on or after this date, such as 2026-10-01.

It also takes the global options --json and --help.

See also