Skip to content

lerim connect

Manage trace-source connections for session ingestion.

Overview

Register, list, or remove trace-source connections. Lerim reads session data from connected platforms to build shared context records.

Current supported platforms are coding-agent trace sources: claude, codex, cursor, opencode

Syntax

lerim connect list
lerim connect
lerim connect auto
lerim connect <platform> [--path PATH]
lerim connect remove <platform>

Subcommands

Auto-detect all current platforms

lerim connect auto

Scans default paths for each current trace-source platform and registers any that are found.

Connect a specific platform

lerim connect claude
lerim connect codex
lerim connect cursor
lerim connect opencode

Connect with custom path

lerim connect claude --path /custom/path/to/claude/sessions
lerim connect cursor --path ~/my-cursor-data/globalStorage

The path is expanded (~ is resolved) and must exist on disk.

List connections

lerim connect list
lerim connect

Disconnect a platform

lerim connect remove claude

Parameters

platform_name string optional

Action or platform: list, auto, remove, or a platform name. Omit it to list connected platforms.

--path string

Custom filesystem path to the platform's session store. Overrides auto-detected default.

Default session paths

Platform Default path
claude ~/.claude/projects/
codex ~/.codex/sessions/
cursor ~/Library/Application Support/Cursor/User/globalStorage/ (macOS)
opencode ~/.local/share/opencode/

  • lerim init

    Interactive setup wizard

    lerim init

  • :material-ingest: lerim ingest

    Ingest sessions after connecting

    lerim ingest