GIT-REMOTE-FD(1)

💅 git-remote-fd(1) — the git manual, but make it make sense 🎀

okay so bestie, you're reading the git-remote-fd page from the Git Manual — and no, this one is NOT for you casually typing git commands, iykyk. Let's get into it ✨

---

🌸 NAME 🌸

git-remote-fd — literally just reflects the smart transport stream right back to whoever called it 🔁

---

🦋 SYNOPSIS 🦋

"fd::<infd>[,<outfd>][/<anything>]" (as URL)

that's the whole shape of it, bestie — a URL-looking thing with file descriptors in it 💅

---

💖 DESCRIPTION 💖

so this helper uses the file descriptors you specify to connect to a remote Git server. periodt. it is not meant for end users — it's for programs and scripts that are calling git fetch, push, or archive 🫶

if you give it only <infd>, it assumes that's a bidirectional socket connected to a remote Git server (git-upload-pack, git-receive-pack, or git-upload-archive). one fd, both directions, main character energy ✨

if you give it both <infd> and <outfd>, they're assumed to be pipes connected to a remote Git server — where <infd> is the inbound pipe and <outfd> is the outbound pipe 🎀

fr fr it also assumes any handshaking procedures are already done (like sending the service request for git://) before this helper even starts. so don't come at it with unfinished business 😭

and <anything>? it can be any string. it is ignored. it's just there so the URL carries info for the user in case that URL gets displayed somewhere in some context 👑

---

🧚 ENVIRONMENT VARIABLES 🧚

• GIT_TRANSLOOP_DEBUG — if set, prints debugging information about various reads/writes 🔍

---

🔥 EXAMPLES 🔥

git fetch fd::17 master

fetch master, using file descriptor #17 to communicate with git-upload-pack 💫

git fetch fd::17/foo master

same as above, no cap 🌈

git push fd::7,8 master (as URL)

push master, using file descriptor #7 to read data from git-receive-pack and file descriptor #8 to write data to the same service 🍓

git push fd::7,8/bar master

same as above, literally identical vibe 💜

---

⭐ SEE ALSO ⭐

gitremote-helpers(7) — go read that one too, bestie 🦋

---

👑 GIT 👑

part of the git(1) suite 💅

---

and that's the page, gorgeous 🌸 — this was Git 2.56.0, dated 2026-09-27, signing off with all the love and zero of the manpage stiffness 🎀🫶✨