Skip to main content

Command overview

beacon endpoint devin reads the committed SQLite session store Devin CLI keeps at ~/.local/share/devin/cli/sessions.db (%APPDATA%\devin\cli\sessions.db on Windows) and maps it into Beacon endpoint events.
Command syntax
This complements the live Devin CLI hooks. Hooks remain the real-time integration; the sync adds what the hook payload cannot carry: assistant replies, reasoning, per-message token metrics and the per-turn model. See Session database sync. Every event from this command is marked harness.collection_method=poll. Beacon reads committed records after the fact, so this path cannot hold, approve, deny, or delay a tool call. Reading is local, offline and read-only.

Commands

Flags

Both subcommands accept: sync also accepts:

Sweeping

Sweep once
Preview without writing or advancing the cursor
Sweep continuously
Nothing schedules a sweep automatically. Run sync from the scheduler used on the endpoint, or leave --watch running in the account that owns the Devin CLI data directory. When the runtime log shows live hook coverage for a session, the sweep skips the prompts, tool calls and results and session start the hooks already recorded and keeps only the events the hook payload cannot carry, so nothing is counted twice.

Status

Show sessions and collection progress
The cursor prevents scheduled sweeps from re-appending a session’s complete history. Each source record always maps to the same deterministic event id, so a re-read after a cursor reset appends events with the ids they had before.

Devin CLI

Hook installation, telemetry coverage, and the session database sync.

beacon endpoint hooks

Install and inspect the live Devin CLI hook integration.