CLI reference
heddle push
Shippedheddle push [OPTIONS] [REMOTE] [THREAD] Push the source-authoritative history to a remote
Output text (default) · json
Arguments
[REMOTE]value optional- Heddle remote name, native repository path, or hosted address
[THREAD]value optional- Thread to push; alias for `--thread`
Flags
--thread <THREAD>, -t <THREAD>- Thread to push
--state <STATE>, -s <STATE>- State to push (default: HEAD)
--force <FORCE>, -f <FORCE>- Force push values:
true · false --all-threads <ALL_THREADS>- Push every thread. In Git Overlay, also include every local Git tag values:
true · false --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 --dry-run <DRY_RUN>- Perform no mutation values:
true · false --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- remote rejected payload; do not retry without changing inputs
78- no upstream configured