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

# Local Trace Sources

> Read your agent's runs from local transcripts and JSONL exports — no cloud account needed.

When your agent runs on your own machine, Helix reads its traces from local sources — the transcripts
your coding agent already writes, or a JSONL export. Everything stays on disk; nothing is uploaded.

<CardGroup cols={2}>
  <Card title="Claude Code transcripts" icon="https://mintcdn.com/architech/lNudYrm3oSHgdKIT/icons/claude-code.svg?fit=max&auto=format&n=lNudYrm3oSHgdKIT&q=85&s=233c2a58e7ec44d3d20fc0c14fa5aa85" width="1200" height="1200" data-path="icons/claude-code.svg">
    Reads sessions your Claude Code agent writes under `~/.claude/projects/`. Works out of the box —
    point Helix at the project and it finds the runs.
  </Card>

  <Card title="Codex transcripts" icon="https://mintcdn.com/architech/lNudYrm3oSHgdKIT/icons/codex.svg?fit=max&auto=format&n=lNudYrm3oSHgdKIT&q=85&s=d59281120906f1d921067d48eafe7c3b" width="16" height="16" data-path="icons/codex.svg">
    Reads Codex session transcripts (`~/.codex/sessions/`) in the same way.
  </Card>

  <Card title="Pi / Oh My Pi transcripts" icon="https://mintcdn.com/architech/lNudYrm3oSHgdKIT/icons/pi.svg?fit=max&auto=format&n=lNudYrm3oSHgdKIT&q=85&s=3862e35f8e6e51beac82944664b079b0" width="800" height="800" data-path="icons/pi.svg">
    Reads Pi and Oh My Pi session transcripts for agents built on those runtimes.
  </Card>

  <Card title="JSONL export" icon="file-export">
    Any agent that can emit a trace in JSONL/NDJSON form — one run per line — can be read as a
    source. Bring your own format; gzipped files are supported.
  </Card>
</CardGroup>

## How it connects

Point Helix at the source and it binds it to Evaluate and Diagnose:

```yaml .mutagent/config.yaml theme={null}
global:
  sources:
    - name: sessions
      platform: claude-code      # claude-code · codex · local-jsonl · langfuse · otel
```

A single local source needs no credentials. For a JSONL export, point `paths` at your files. See the
[config reference](/helix/reference/config#globalsources) for every key.

<Tip>
  Have traces in a hosted observability platform instead? See
  [OpenTelemetry sources](/integrations/sources/otel).
</Tip>