heddle daemon

The mount daemon exposes Heddle's content-addressed object store through a filesystem interface, useful for editors that want to load historical states without checking them out. It shares nothing with heddle agent beyond the general shape of the word — agent is the writer-lease API, daemon is the mount control plane.

Three subcommands: serve runs a foreground mount daemon for this repository; status reports liveness, version, uptime and active mount count, succeeding as a no-op when the daemon is not running; stop asks the daemon to drain its mounts and exit, sweeping leftover registry entries as a safety net.

Only the mount path is platform-gated. heddle daemon serve requires a binary built with --features mount on Linux (FUSE), macOS (FSKit) or Windows (ProjFS); on an unsupported build it refuses rather than silently degrading.

Examples

Check whether the daemon is up

bash$ heddle daemon status --output json

See also

• heddle agent
• heddle start