sshgit

Git remote operations (clone, fetch, pull, push) over SSH. Built on dulwich and paramiko.

Installation

pip install sshgit

Usage

sshgit clone <remote-path> [dest]

Clone a remote repository over SSH.

sshgit clone /home/me/project.git --host devbox --username me
sshgit clone /srv/repos/app.git --host 10.0.1.5 --port 2222 --ed25519-key ~/.ssh/id_ed25519
sshgit clone /home/me/repo.git ./local-repo --host myserver --username deploy --password
sshgit clone /opt/repos/lib.git --host bastion --rsa-key ~/.ssh/id_rsa --branch main

sshgit fetch [refspec]

Fetch objects and refs from the remote. Reads connection details from .git/config.

sshgit fetch
sshgit fetch main
sshgit fetch --prune

sshgit pull [branch]

Fetch and fast-forward the current branch. Refuses if the branch has diverged.

sshgit pull
sshgit pull main

sshgit push [refspec]

Push local commits to the remote.

sshgit push
sshgit push main
sshgit push --force
sshgit push --tags

Authentication

One of --ed25519-key, --rsa-key, or --password is required on every invocation. No implicit agent or config file lookup.

Jump Host (Proxy)

All commands accept these optional flags for connecting through a bastion host:

Contributing

Contributions are welcome! Please submit pull requests or open issues on the GitHub repository.

License

This project is licensed under the MIT License.