git-remote-htree

Git remote helper for hashtree - push/pull git repos via Nostr and hashtree.

Installation

cargo install hashtree-cli git-remote-htree

If you already have hashtree-cli, just install the helper:

cargo install git-remote-htree

Usage

# Clone a repo
git clone htree://npub1.../repo-name

# Push your own repo
git remote add htree htree://self/myrepo
git push htree master

# Link-visible repo (encrypted, shareable via secret URL)
git remote add origin htree://self/myrepo#link-visible
git push origin main

# Clone with secret key
git clone htree://npub1.../repo#k=<64-hex-chars>

# Private repo (encrypted, author-only)
git remote add origin htree://self/myrepo#private
git push origin main

P2P

For P2P sharing between peers, run the hashtree daemon:

htree start

Git operations automatically use the local daemon when running, enabling direct peer-to-peer transfers via WebRTC.

Configuration

Keys file: ~/.hashtree/keys

nsec1abc123... default
nsec1xyz789... work

Use petnames in remote URLs: htree://work/myproject

Part of hashtree-rs.