CLI reference

heddle daemon

Foundation

heddle daemon <subcommand>

The FUSE mount daemon. Surfaces Heddle threads as virtual filesystems so editors and shell tools see them as ordinary files. Requires a build with `--features mount`, on Linux (FUSE), macOS (FSKit), or Windows (ProjFS).

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, and for shell pipelines that prefer cat over heddle show. Mount paths are negotiated by client RPC (heddle thread start --daemon), not by CLI flags.

Three subcommands: serve, status, stop. Only serve is platform-gated (it's the one that mounts); status and stop work everywhere. serve runs the daemon in the foreground; status probes the live endpoint; stop requests a graceful shutdown.

Shipping constraint: only the *mount* path (heddle daemon serve) requires the binary to be built with --features mount on a supported platform: Linux (FUSE), macOS (FSKit), or Windows (ProjFS). On an unsupported build, heddle daemon serve returns 'Virtualized workspace requires Linux/macOS/Windows + heddle built with --features mount'.

Examples

Start the daemon (build with --features mount)

bash$ heddle daemon serveheddle daemon serving

Check whether the daemon is up

bash$ heddle daemon statusdaemon: ok=true version=0.5.1 uptime_s=842 mount_count=3

Examples

See also