CLI Reference

Remote commands: alpha status

Remote configuration is available, local-path clone works, and repository transfer is disabled.

Transfer commands fail closed

push, pull, fetch, and sync return a nonzero exit status for both local-path and network remotes. They do not transfer data or change the repository.

Remote configuration

You can store and inspect remote names and URLs. This configuration does not make transfer commands operational.

dits remote add origin /path/to/another-repository
dits remote list
dits remote get-url origin
dits remote set-url origin /new/local/path
dits remote rename origin archive
dits remote remove archive

Configuration is stored as JSON in .dits/remotes. If that file is malformed, remote reads, edits, and disabled transfer commands return an error without replacing it; repair or restore the file explicitly.

Local clone

clone currently accepts a repository on the local filesystem. Network URLs are rejected with a nonzero exit status.

dits clone /path/to/source-repository destination
dits clone --help

Disabled commands

dits push does not upload commits or objects.
dits pull does not fetch or merge remote state.
dits fetch does not download objects or update refs.
dits sync does not perform bidirectional synchronization.

Follow the roadmap for planned remote transport work. Scripts should treat a nonzero result from these commands as a hard failure.