CLI reference

heddle pull

Shipped

heddle pull [OPTIONS] [REMOTE]

Pull source-authoritative history from a remote

Output text (default) · json

Arguments

[REMOTE] value optional: Heddle remote name, native repository path, or hosted address

Flags

--thread <THREAD>, -t <THREAD>: Thread to act on
--insecure <INSECURE>: Allow cleartext (non-TLS) connections to non-loopback hosts. Prefer enabling TLS; use this only for intentional lab/VPN testing values: true · false
--local-thread <LOCAL_THREAD>, -l <LOCAL_THREAD>: Local thread to update
--lazy <LAZY> hidden: Request lazy blobs. Hosted pull currently rejects this planned mode values: true · false Accepted by the CLI, but absent from standard --help.
--op-id <OP_ID> hidden: Operation id (UUID v4) for idempotent retries. See `heddle help operation-ids` Accepted by the CLI, but absent from standard --help.

Exit codes

Declared by this command's contract, verbatim. Anything not listed contracts only to 0 on success and an unspecified non-zero on failure. The full table and the retry rule — in short, 75 is the only code that is safe to retry.

0: ok
75: remote unreachable; safe to retry
76: upstream protocol error
78: no upstream configured