---
title: "tori logs"
description: "read retained app stdout and stderr"
---

read retained app stdout and stderr

## Usage

```
npx tori.host logs [--follow] [--since 15m] [--limit 200]
```

Reads the app in ./tori.json. `--since` accepts seconds, minutes, or hours (24h maximum); `--limit` accepts 1–500 lines for one-shot reads. `--follow` polls every three seconds and replays a 30-second window for delayed logs. Queued logs arriving later need a historical query. Ctrl-C stops following. Output is chronological.

No matching logs and unavailable log storage are reported separately.

## Options

- `--follow, -f` — Poll for new lines until interrupted.
- `--since <duration>` — How far back to read. Seconds, minutes, or hours; 1s–24h. (default 15m)
- `--limit <n>` — Maximum lines for a one-shot read (1–500). (default 200)
- `--no-browser` — sign in with a code you type on another device (chosen automatically over SSH or with no DISPLAY)



## Examples

### Read the last hour

```sh
npx tori.host logs --since 1h --limit 500
```

### Follow new lines

```sh
npx tori.host logs --follow
```

This reference matches `tori.host@0.9.7`.

Download this page as [Markdown](/downloads/markdown/cli/logs.md).