git-remote-rns 0.1.0

Git remote helper for syncing repositories over Reticulum

git-remote-rns

Reticulum remote transport for git. A mirror of this repo is hosted at rns::6969b682832a26db5bcf2b5818e9d2f0/git-remote-rns.

Installation

pipx install git_remote_rns

Usage

Start the rngit server to expose the repository

rngit --allow-all-read /path/to/repository

Take note of the destination hexhash that it outputs and then clone the repo.

git clone rns::<hexhash> my_repo
cd my_repo

If you want to push changes to the server, you can allow specific identities to push changes with --allow-write.

rngit --allow-write <identity> /path/to/repo

You can limit reading to only allow certain identities to access the repository with --allow-read.

rngit --allow-read <identity> /path/to/repo

Any identities specified in --allow-write will automatically have --allow-read.

If you don't specify any --allow-* flags, nobody will be able to access the server by default.

The /path/to/repo directory can point to a parent directory with child directories that are the repositories, in which case you can specify which repo you want to interact with when cloning.

git clone rns::<hexhash>/my_repo

The repositories can be bare repositories, or a worktree with the .git folder inside it. I don't recommend hosting the worktree versions though, as you wont be able to push updates to the checked out branch.