Docs Local development

The local daemon

A small background process that powers Conflict Radar, hooks, and the browser bridge.

The gridtrue daemon is a small long-lived process that runs in the background on your workstation. Start it once after install; the hooks and browser bridge talk to it over a local socket.

Lifecycle

bash

gridtrue daemon start      # launches in the background
gridtrue daemon status     # prints pid, uptime, connected orgs
gridtrue daemon logs -f    # tails the daemon log
gridtrue daemon stop       # clean shutdown

What the daemon does

Subscribes to Conflict Radar events for every repo you have open.
Serves the hooks: pre-commit / pre-push call it over a local socket instead of spawning the CLI.
Exposes the browser bridge at http://localhost:14762 so the gridtrue web UI can talk to your keyring-held identity without shipping the key through the browser.
Caches attestations for offline validation. Runs gridtrue export --from-cache with no network access.

Where it lives

Config: ~/.gridtrue/config.toml — per-machine settings (log level, proxies, default org).
State: ~/.gridtrue/state/ — cached ledger events, keyed by org slug. Safe to delete; the daemon re-syncs on restart.
Socket: macOS / Linux: ~/.gridtrue/daemon.sock. Windows: a named pipe at \\.\pipe\gridtrue-daemon.
Logs: ~/.gridtrue/logs/daemon.log (rotated daily, 7 files kept by default).