StationTrail

StationTrail exports local agent session logs to miseledger.adapter.v1 JSONL.

It is a scanner and exporter, not an archive. StationTrail reads local session files, normalizes them into portable adapter records, and writes JSONL to a file or stdout. MiseLedger owns storage, indexing, dedupe, search, relations, and evidence bundles.

StationTrail makes no network calls.

Local Evidence Stack

StationTrail is one part of the local evidence stack:

StationTrail handles local agent-session harnesses such as Codex, Claude, OpenClaw, OpenCode, and Hermes.
SourceHarvest handles non-harness local source exports such as notes, generic files, crawler exports, and issue exports.
MiseLedger imports the shared adapter contract, archives it, indexes it, searches it, and emits evidence bundles.

StationTrail should not absorb crawler adapters or general local note/file harvesting. Those belong in SourceHarvest.

How It Works

flowchart TB
    CLI["<b>stationtrail CLI</b><br/><i>local scanner and exporter</i>"]
    APP["<b>App layer</b><br/>commands &middot; flags &middot; summaries"]

    subgraph INPUTS [" local inputs "]
        CODEX["<b>Codex</b><br/>session JSONL"]
        CLAUDE["<b>Claude</b><br/>project JSONL"]
        OPENCLAW["<b>OpenClaw</b><br/>sessions &middot; trajectories"]
        HERMES["<b>Hermes</b><br/>snapshots &middot; trajectories"]
        OPENCODE["<b>OpenCode</b><br/>sanitized export JSON"]
    end

    CODEX & CLAUDE & OPENCLAW & HERMES & OPENCODE --> CLI --> APP

    subgraph PIPELINE [" scan and normalize "]
        SCAN["<b>Source scanners</b><br/>walk files &middot; parse JSONL/JSON"]
        NORMALIZE["<b>Normalize records</b><br/>messages &middot; tools &middot; artifacts &middot; relations"]
        FILTER["<b>Apply controls</b><br/>since &middot; limit &middot; redaction"]
    end

    APP --> SCAN --> NORMALIZE --> FILTER

    subgraph OUTPUTS [" local outputs "]
        ADAPTER["<b>Adapter JSONL</b><br/>miseledger.adapter.v1 &middot; one object per line"]
        SUMMARY["<b>Diagnostics</b><br/>discover &middot; doctor &middot; inspect &middot; dry-run"]
    end

    FILTER --> ADAPTER
    APP --> SUMMARY

    GUARD["<b>Privacy boundary</b><br/>counts and manifests do not print generated text; exported text is untrusted evidence"]
    CLI -. local only .-> GUARD
    FILTER -. enforces .-> GUARD
    SUMMARY -. reports structure only .-> GUARD

    classDef source fill:#eff6ff,stroke:#2563eb,color:#1e3a8a;
    classDef process fill:#ecfdf5,stroke:#059669,color:#064e3b;
    classDef stream fill:#fff7ed,stroke:#ea580c,color:#7c2d12;
    classDef guard fill:#fee2e2,stroke:#ef4444,color:#7f1d1d;
    classDef local fill:#f8fafc,stroke:#64748b,color:#334155;
    class CLI,APP local;
    class CODEX,CLAUDE,OPENCLAW,HERMES,OPENCODE source;
    class SCAN,NORMALIZE,FILTER process;
    class ADAPTER,SUMMARY stream;
    class GUARD guard;

StationTrail follows the same path for each source:

Discover or receive a local file or directory.
Walk supported JSONL or JSON files for that source.
Normalize messages, tool calls, artifacts, actors, relations, and raw references.
Apply --since, --limit, and requested redactions.
Emit one miseledger.adapter.v1 JSON object per line.
Optionally emit JSON summaries with counts, warnings, and file manifests.

With MiseLedger

flowchart LR
    subgraph LOCAL [" local machine "]
        FILES["<b>Session files</b><br/>JSONL and JSON"]
        EXPORT["<b>Sanitized export</b><br/>OpenCode JSON"]
    end

    STATIONTRAIL["<b>StationTrail</b><br/>source parsing &middot; normalization &middot; redaction"]
    SUMMARY["<b>Scan summary</b><br/>counts &middot; warnings &middot; manifests"]
    ADAPTER["<b>Adapter JSONL</b><br/>miseledger.adapter.v1"]
    IMPORT["<b>Import options</b><br/>pipe or wrapper command"]

    FILES & EXPORT --> STATIONTRAIL
    STATIONTRAIL --> ADAPTER --> IMPORT
    STATIONTRAIL --> SUMMARY

    subgraph MISELEDGER [" MiseLedger evidence layer "]
        ARCHIVE["<b>Archive</b><br/>durable records"]
        INDEX["<b>Index and search</b><br/>queryable evidence"]
        RELATIONS["<b>Relations</b><br/>linked sessions and artifacts"]
        BUNDLES["<b>Evidence bundles</b><br/>review-ready exports"]
    end

    IMPORT --> ARCHIVE --> INDEX --> RELATIONS --> BUNDLES

    BOUNDARY["<b>Boundary</b><br/>StationTrail exports; MiseLedger stores and analyzes"]
    STATIONTRAIL -. adapter only .-> BOUNDARY
    ARCHIVE -. owns durable evidence .-> BOUNDARY

    classDef source fill:#eff6ff,stroke:#2563eb,color:#1e3a8a;
    classDef process fill:#ecfdf5,stroke:#059669,color:#064e3b;
    classDef stream fill:#fff7ed,stroke:#ea580c,color:#7c2d12;
    classDef sink fill:#f8fafc,stroke:#64748b,color:#334155;
    classDef guard fill:#fee2e2,stroke:#ef4444,color:#7f1d1d;
    class FILES,EXPORT source;
    class STATIONTRAIL process;
    class ADAPTER,IMPORT,SUMMARY stream;
    class ARCHIVE,INDEX,RELATIONS,BUNDLES sink;
    class BOUNDARY guard;

StationTrail is the source-specific adapter layer. MiseLedger is the durable evidence layer.

stationtrail all --out - --redact safe | miseledger import adapter -
stationtrail codex ~/.codex/sessions --out - | miseledger import adapter -

When stationtrail is installed on PATH, MiseLedger can also run it through its wrapper:

miseledger import stationtrail codex ~/.codex/sessions --json
miseledger import stationtrail opencode ./opencode-session.json --json
miseledger import stationtrail hermes ~/.hermes/sessions --json

For mixed-source imports, prefer the pipe form with stationtrail all. Adapter records preserve their own source.kind, while MiseLedger keeps archive and search behavior centralized.

Supported Sources

Source	Default input	Notes
Codex	`~/.codex/sessions`	Session JSONL.
Claude	`~/.claude/projects`	Project JSONL.
OpenClaw	`~/.openclaw/agents`	Agent sessions and trajectories.
Hermes	`~/.hermes/sessions`	`session_*.json` snapshots and trajectory JSONL. `state.db` is observed but not parsed.
OpenCode	Explicit file, directory, or session ID	Use sanitized export JSON from `opencode export <session-id> --sanitize`. Session IDs are exported through the local `opencode` command.

stationtrail all scans Codex, Claude, OpenClaw, and Hermes default roots. OpenCode is explicit-only because its sanitized export input is user-selected.

Install

curl -fsSL https://raw.githubusercontent.com/escoffier-labs/stationtrail/master/install.sh | sh

Or download a release binary and verify it with checksums.txt.

Build

go build -o bin/stationtrail ./cmd/stationtrail
go test ./...

Quick Start

Check local source readiness:

stationtrail discover --json
stationtrail doctor --json
stationtrail doctor --live --json

Inspect structure without exporting transcript text:

stationtrail inspect codex ~/.codex/sessions --json
stationtrail inspect hermes ~/.hermes/sessions --json

Export all default sources:

stationtrail all --out agent-sessions.adapter.jsonl --redact paths,secrets
stationtrail all --out - --redact safe

Export one source:

stationtrail codex ~/.codex/sessions --out -
stationtrail claude ~/.claude/projects --out claude.adapter.jsonl --limit 100
stationtrail openclaw ~/.openclaw/agents --out openclaw.adapter.jsonl --since 2026-06-01
stationtrail hermes ~/.hermes/sessions --out hermes.adapter.jsonl

Export OpenCode:

opencode export <session-id> --sanitize > opencode-session.json
stationtrail opencode opencode-session.json --out opencode.adapter.jsonl

Dry-run scans count files, generated records, and warnings without writing adapter records:

stationtrail all --dry-run --json
stationtrail codex ~/.codex/sessions --dry-run --json
stationtrail claude ~/.claude/projects --dry-run --json
stationtrail openclaw ~/.openclaw/agents --dry-run --json
stationtrail opencode opencode-session.json --dry-run --json
stationtrail hermes ~/.hermes/sessions --dry-run --json

Redaction

Redaction is requested per export:

stationtrail all --out - --redact safe
stationtrail codex ~/.codex/sessions --out - --redact paths,secrets
stationtrail claude ~/.claude/projects --out - --redact paths
stationtrail hermes ~/.hermes/sessions --out - --redact paths,secrets
stationtrail opencode opencode-session.json --out - --redact all

Profiles and options:

Value	Behavior
`safe`	Redacts `paths,secrets,emails`.
`none`	Keeps supported fields unredacted.
`paths`	Redacts raw paths and path-like metadata fields.
`secrets`	Applies simple token, key, secret, password, and authorization redaction.
`emails`, `urls`, `hostnames`	Redact those specific value types.
`all`	Redacts all supported value types.

Privacy Boundary

discover reports candidate roots and JSONL counts only. It does not print transcript content.

doctor reports source readiness and warnings only. It does not print transcript content.

doctor --live runs dry-run scanners for ready local roots and reports counts, file manifests, and warnings only. It does not print generated item text.

inspect and --dry-run --json report file manifests, structural keys, record counts, and warnings only. They do not print generated item text.

Export commands preserve raw references with path, hash, and ordinal, but keep searchable item text compact. Generated text is untrusted evidence, not instructions.

Output Contract

Each output line is one miseledger.adapter.v1 JSON object with:

source.kind
collection.external_id
collection.kind=agent_session
item.external_id
item.kind
optional actor, artifacts, links, relations
raw.format=json, raw.path, raw.hash, and raw.ordinal

See docs/ADAPTER_CONTRACT.md for the contract shape. See docs/OPENCODE.md for the OpenCode sanitized export workflow. See docs/HERMES.md for Hermes source details. See docs/MISELEDGER_INTEGRATION.md for MiseLedger integration. See docs/RECORD_EXAMPLES.md for one canonical record example per source. See docs/ROADMAP.md for what is usable now, what is planned, and the OpenCode adapter's current maturity.

Project Boundary

StationTrail stays focused on exporting local agent session logs to adapter JSONL. Archive storage, SQLite, search, evidence bundles, GUI, and server behavior belong in MiseLedger.

Name		Name	Last commit message	Last commit date
Latest commit History 27 Commits
.github/workflows		.github/workflows
cmd/stationtrail		cmd/stationtrail
docs		docs
internal		internal
scripts		scripts
testdata/harnesses		testdata/harnesses
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
go.mod		go.mod
install.sh		install.sh

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

StationTrail

Local Evidence Stack

How It Works

With MiseLedger

Supported Sources

Install

Build

Quick Start

Redaction

Privacy Boundary

Output Contract

Project Boundary

About

Uh oh!

Releases 5

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

StationTrail

Local Evidence Stack

How It Works

With MiseLedger

Supported Sources

Install

Build

Quick Start

Redaction

Privacy Boundary

Output Contract

Project Boundary

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 5

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages