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. Linux + `--features mount` build only.

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 — none of which take flags. serve runs the daemon in the foreground; status probes the live endpoint; stop requests a graceful shutdown.

Shipping constraint: the daemon is Linux-only and requires the binary to be built with --features mount. On other platforms / builds, heddle daemon serve returns 'Virtualized workspace requires Linux + heddle built with --features mount'.

Examples

Start the daemon (Linux + --features mount build)

bash$ heddle daemon serveheddle daemon serving

Check whether the daemon is up

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

Examples

See also