> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fimo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Runs, reports & logs

> List an agent's past runs and read the report it produced to see exactly what it did.

Every agent run creates a session on the server. The CLI lets you list those sessions and read the **report** — the agent's final message, captured when the run finishes.

## List past runs

```bash theme={null}
fimo agents runs <name>                 # compact table of recent sessions
fimo agents runs <name> --limit 50 --env preview
```

Each row shows the session id, start time, duration, status, trigger, environment, and cost. The default limit is 20; `--env` filters to a single environment.

## Read a run's report

The report is the fastest way to see what a run actually produced — for a read-only agent it *is* the output (an audit), and for a write agent it's a "what I changed" summary:

```bash theme={null}
fimo agents report <name>               # most recent run
fimo agents report <name> --session <id>
fimo agents report seo-audit | glow     # raw markdown pipes cleanly
```

With no `--session`, the latest run is used; combine with `--env` to scope. If a run hasn't finished or produced no message, the command says so and shows the stop reason when there is one.

## Logs

```bash theme={null}
fimo agents logs <name> --session <id>
```

<Note>
  The log-streaming endpoint is still a server-side stub, so `logs` currently prints a placeholder rather than live log lines. To read a finished run's output today, use `fimo agents report`.
</Note>

## What's next

<Columns cols={3}>
  <Card title="Schedules" icon="calendar" href="/docs/agents/schedules">
    Trigger runs on a cron or on demand.
  </Card>

  <Card title="Create an agent" icon="plus" href="/docs/agents/create">
    Author and activate a bundle.
  </Card>

  <Card title="Agents overview" icon="robot" href="/docs/agents/overview">
    How activations and run sessions relate.
  </Card>
</Columns>