CLI reference

heddle push

Shipped
heddle 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