Configuration

One YAML file. Every command reads asz.yaml from the working directory when no -config flag is given, and -config FILE names another one. The file at the repository root is the default configuration with every value written out, and a test holds it to the compiled defaults, so reading that file is reading the defaults.

storage:
  root: ./data

adapters:
  - name: claude-code-local
    enabled: true
    source_root: ""
    include: []
    exclude:
      - /private/tmp/**
    collector:
      mode: watch
      interval: 5s
      max_delta_bytes: 2097152

storage

Key	Default	Meaning
`root`	`./data`	The storage root: where collected data lands and where conversations are assembled. A relative path is resolved from the working directory.

The default is ignored by git, so running the collector inside a checkout never stages private transcripts.

adapters

A list. Version 0.1.0 has one adapter, claude-code-local, which reads Claude Code’s files from this machine. Every command runs once per enabled adapter.

Key	Default	Meaning
`name`		`claude-code-local`
`enabled`	`true`	A disabled adapter is skipped by every command.
`source_root`	empty	Where Claude Code keeps its files. Empty resolves it the way Claude Code does: `CLAUDE_CONFIG_DIR`, then `XDG_CONFIG_HOME/claude`, then `~/.claude`, each followed by `projects`. Set it only to collect from a copy or a mounted directory.
`include`	empty	Session filters, see below. Empty means every session is a candidate.
`exclude`	`/private/tmp/**`	Session filters, see below.

Session filters

A session is judged by the working directory its main transcript was recorded under. An entry that starts with / is a working directory, and ** after it matches everything beneath. Anything else is a glob matched against the source directory name as Claude Code wrote it, which is the working directory with every separator replaced by -.

A session’s child agents can run in other directories, so the filter looks at the main transcript only. A session that merely used a scratch directory for a child agent is still collected. When the main transcript has been pruned, the session is judged on all of its directories together and is excluded only when every one of them matches, so an orphaned child stream from a real project is still collected.

Claude Code runs its own helper agents in scratch directories under /private/tmp. Those sessions are the tool’s, not yours, which is why they are excluded by default.

collector

Key	Default	Meaning
`mode`	`watch`	`watch` polls the source continuously. `once` makes a single pass and exits, which is the backfill path over history that already exists. `-once` on the command line overrides the file.
`interval`	`5s`	How long the collector sleeps between passes in watch mode. `asz view` refreshes on the same interval.
`max_delta_bytes`	`2097152`	The largest `.sd` file the collector writes, 2 MiB. A large catch-up is split into several files, and a single record larger than this is landed whole. A file travels whole as one log record, so this is also the largest record a receiver has to accept. A change applies to new files only; `asz repack` brings an existing root under a new budget.

parse

parse:
  max_round_bytes: 2097152

Key	Default	Meaning
`max_round_bytes`	`2097152`	The largest `.sf` round file the parser writes, 2 MiB, the same budget as a landed file. A round travels whole as one log record. The parser narrows a round’s input window until the round fits and leaves the rest of the evidence to the next round, so one parse pass may write several rounds. A round covering a single landed file is published whole even when larger.

export

export:
  otlp:
    endpoint: ""
    service_name: ""
    instance_id: ""
    layer: AI_AGENT
    batch_bytes: 8388608
    interval: 5s

Key	Default	Meaning
`endpoint`	empty	The OpenTelemetry logs receiver’s base URL; `/v1/logs` is appended. The SkyWalking OAP listens on its REST port, `http://127.0.0.1:12800` by default. Empty means `asz push` refuses to run.
`service_name`	empty	The service every record is attributed to. Empty means the runtime the adapter reads, `Claude Code` for `claude-code-local`: one service per kind of agent.
`instance_id`	empty	Sent as `service.instance.id`, the identity of this sender. Empty means a new UUID each time `asz push` starts.
`layer`	`AI_AGENT`	Sent as `service.layer`, the layer the receiver places the service in. The OAP selects its rules by layer, and a layer name is upper case with underscores.
`headers`	none	Headers added to every request, for example `Authorization`.
`batch_bytes`	`8388608`	How many file bytes one request carries at most, 8 MiB, which keeps a request under the 10 MiB the OAP’s HTTP server accepts. A file larger than this is sent alone, in a request of its own.
`interval`	`5s`	How long `asz push` sleeps between passes in watch mode.

See Export over OpenTelemetry for what is sent.

Precedence

-config FILE on the command line.
./asz.yaml in the working directory.
The compiled defaults, which are the values shown above.

A file may leave keys out. Anything unset takes its default, except that a file which lists adapters replaces the whole list.

AI Sessionizer