Skip to content

Loopcaptain and OpenTelemetry

Loopcaptain sends no telemetry and takes none. The files in .loops/ are the interface. This page says how they map onto OpenTelemetry for anyone who wants loops beside agent traces, and how to switch on an agent's own telemetry next to a loop.

The mapping follows the GenAI semantic conventions, which are a draft in development status (open-telemetry/semantic-conventions-genai). Names may change; this page will follow them.

The mapping

Loopcaptain OpenTelemetry
a loop (loop.json) a workflow; the loop id as gen_ai.conversation.id
a round (round_started to round_finished) a span under the workflow, loopcaptain.round = the number
a step (step_finished) an agent invocation span (invoke_agent), named by the step id
cost.tokens_in, cost.tokens_out gen_ai.usage.input_tokens, gen_ai.usage.output_tokens
a finding, a verdict, a check an evaluation result event, or loopcaptain.* attributes
anything without a standard name loopcaptain.*: stop_reason, outcome, metrics, the open findings

at, where a line carries it, is the span's time; ts is when the line was written.

The agents' own telemetry

Most coding agents can export OpenTelemetry for each model call: tokens, cost and tool calls per session. Switch it on in the agent, as its own documentation says, and send it where you like. Put the session id in a step's session field and the board shows it beside the step, so a round on the board and the agent's traces can be joined by hand.

Loops that run elsewhere

The board is local by design. A loop that runs on another machine, in CI or a container, writes its .loops/ folder there; sync that folder to a repository the board watches (a pull, a shared folder, rsync), and the board reads it like any other. The inbox flows back the same way.

An exporter

Not built yet: a separate process that tails events.jsonl and sends OTLP along the mapping above, off by default, in its own dependency group. Any backend that takes OTLP would then work. It is finding F15 in .agent/FINDINGS.md; say so there if you need it.