git-remote-htree 0.2.30

# git-remote-htree

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

## Installation

```bash
curl -fsSL https://upload.iris.to/npub1xdhnr9mrv47kkrn95k6cwecearydeh8e895990n3acntwvmgk2dsdeeycm/releases%2Fhashtree/latest/install.sh | sh
```

That installs `htree`, `htree-cashu`, and `git-remote-htree` into `~/.local/bin` by default. For a system-wide install, pass a target directory, for example `sh -s -- /usr/local/bin`.

Windows note: this shell bootstrap is not supported on Windows. Download the latest `hashtree-x86_64-pc-windows-msvc.zip` release asset, extract it, and add `htree.exe`, `htree-cashu.exe`, and `git-remote-htree.exe` to your PATH.

Or install with Cargo:

```bash
cargo install hashtree-cli git-remote-htree
```

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

```bash
cargo install git-remote-htree
```

## Usage

```bash
# 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:

```bash
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](https://git.iris.to/#/npub1xdhnr9mrv47kkrn95k6cwecearydeh8e895990n3acntwvmgk2dsdeeycm/hashtree).