<!-- https://zerolog.ch/docs/jobs · Docs / Agents -->
One entry per run

# Jobs and logs

Every long-running piece of work appears under **Jobs** with its state and its log.

## What gets an entry

Every long-running piece of work

- A goal or ultracode run
- A research run
- An import or export
- A website build

appears under

Jobs

- its state
- its log

Each entry carries its log, not just a status line. The list shows your latest 100 entries. Finished maintenance runs, such as the background summaries of long chats, are hidden behind a toggle that names how many there are and what they cost.

## From running to what it cost

While it runs

### Follow it live

You can follow a running job live, reading the log while the work is still happening. **Cancel run** stops it after a confirmation; a stopped job is paused, not lost.

the run ends

After it ends

### Read it afterwards

The log stays with the job once the run is finished, so you read it afterwards instead of catching it in the moment. Open an entry to see its trace: model calls, shell commands, tokens, time and cost, and how many requests the broker denied. You can download the trace as JSON. A failed job shows why it failed.

Per job

### What it cost

Cost is attributed per job, so you can see what **a particular run** actually cost.

A job that stopped because credit ran out, an approval is needed or a guardrail tripped waits as paused. **Resume** puts it back in the queue; for a guardrail you can grant extra iterations or budget. Goal and ultracode runs that hit an error retry on their own, up to 10 times.

## States of a job

Mermaid source of the diagram on this page:

```mermaid
%% Jobs: the life of one entry. Facts from server/jobs.js (runJob catch ladder, cancelJob, versuchsplan), server/routes/jobs.js, web/apps/web/app/(app)/jobs/page.tsx.
flowchart TB
  q["Queued"]
  r["Running<br/>log grows live"]
  d["Done<br/>log and cost stay"]
  f["Failed<br/>with the reason"]
  p["Paused"]

  q --> r
  r --> d
  r -->|error: retry,<br/>goal and ultracode| q
  r -->|out of retries,<br/>or other types| f
  r -->|no credit, approval,<br/>guardrail, your Cancel| p
  p -->|Resume or Let it<br/>continue| q

  linkStyle 5 stroke:#8f7ac9
```
