Skip to main content

Command overview

beacon endpoint dsh reads the native session records DeepSeek Harness commits under $DSH_HOME/sessions (default ~/.dsh/sessions) and maps them into Beacon endpoint events.
Command syntax
This complements the live DeepSeek Harness hooks. Hooks observe current tool activity and optional policy decisions. Session sync backfills assistant text and reasoning, tool failure status, persisted command/file/MCP detail, and token usage that the hook bridge does not expose. 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 and does not synthesize approval events. Reading is local and offline.

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 $DSH_HOME. A partly written trailing record is left for the next sweep rather than treated as corruption.

Status

Show sessions and collection progress
The cursor prevents scheduled sweeps from re-appending a session’s complete history. Re-reading is safe: the same source record maps to the same deterministic event id.

DeepSeek Harness

Hook installation, telemetry coverage, and known limitations.

beacon endpoint hooks

Install and inspect the live DeepSeek Harness hook integration.