Skip to content

Examples

These examples show the supported workflow shapes without turning config support into a capture claim.

Workflow Use when Evidence boundary
Native coding-agent ingestion The agent has a stable local trace store Lerim already reads Completed sessions can feed Lerim's compiler
MCP context recall The agent can load an MCP server config The agent can query Lerim context after the client loads the config
Generic trace submission A custom agent can export completed sessions The exporter owns capture, cleaning, redaction, and retention
Support-agent trace import Support workflows produce clean completed transcripts Use a support source profile and domain scope
Incident-agent trace import Incident workflows produce clean completed transcripts Use an ops source profile and incident/domain scope

Native Coding-Agent Ingestion

Native adapters are the best path when the agent has a stable local session store.

lerim init
lerim connect claude
lerim connect codex
lerim connect cursor
lerim connect opencode
lerim connect pi
lerim project add .
lerim ingest
lerim context-brief show

Current native adapters:

  • Claude Code
  • Codex CLI
  • Cursor
  • OpenCode
  • pi

See the integration matrix for the current support boundary.

MCP Context Recall

MCP is the universal recall layer. It lets compatible clients ask Lerim for context, but it is not the same as native completed-session capture.

lerim connect gemini-cli --mode mcp --dry-run
lerim connect gemini-cli --mode mcp

The same pattern works for the known MCP targets:

lerim connect codex --mode mcp
lerim connect claude-code --mode mcp
lerim connect cursor --mode mcp
lerim connect opencode --mode mcp
lerim connect cline --mode mcp
lerim connect cline-cli --mode mcp
lerim connect claude-desktop --mode mcp
lerim connect openclaw --mode mcp
lerim connect hermes --mode mcp
lerim connect goose --mode mcp
lerim connect roo-code --mode mcp
lerim connect kilo-code --mode mcp
lerim connect windsurf --mode mcp
lerim connect openhuman --mode mcp

Then validate the local config:

lerim connect doctor gemini-cli

Generic JSONL Trace Submission

Use this when another agent or application can export a completed session.

{"type":"user","message":{"role":"user","content":"Customer asked whether refund approval is required."},"timestamp":"2026-05-19T09:00:00Z"}
{"type":"assistant","message":{"role":"assistant","content":"Agent found refunds above EUR 500 require manager approval."},"timestamp":"2026-05-19T09:02:00Z"}

Import the trace:

lerim trace import ./support-refund-session.jsonl \
  --source-name support-agent \
  --source-profile support \
  --scope-type domain \
  --scope support-ops

Or submit through MCP with lerim_trace_submit from a compatible client.

Support-Agent Trace Import

Support traces should preserve policy evidence, customer constraints, failed fixes, escalation reasons, and handoff state.

lerim trace import ./traces/support/*.jsonl \
  --source-name support-agent \
  --source-profile support \
  --scope-type domain \
  --scope support-ops

lerim context records --profile support
lerim answer "What refund approval constraints should the next support agent know?"

Incident-Agent Trace Import

Incident traces should preserve root causes, mitigations, rejected hypotheses, runbook gaps, owners, and follow-up risks.

lerim trace import ./traces/incidents/*.jsonl \
  --source-name incident-agent \
  --source-profile ops \
  --scope-type domain \
  --scope incident-ops

lerim context records --profile ops
lerim answer "What did we learn from the last incident handoff?"

What Not To Claim

  • MCP config support does not prove native completed-session capture.
  • A temporary config fixture does not prove an installed client called a tool.
  • Retrieval-only benchmark results are not extraction-quality results.
  • A custom JSONL import is only as trustworthy as the upstream exporter and cleaner.