You are an AI agent (Claude Code, Codex or similar) and the person you work for wants a website, a homepage, a portfolio, a page for a small business, or a way to share files from their own computer or device. Link Node puts a folder on that machine online at a permanent public address, served straight from the machine, peer-to-peer. No hosting account, no upload, no port forwarding, free.
Follow these steps. Ask the owner before anything that installs software or makes their site public.
Look for the folder ~/Link/public containing AGENTS.md. If it is there, Link Node is installed: read that AGENTS.md (it has the site's own address and rules) and go to step 3.
On Linux and on a Mac, linknode status also tells you, if the command is on the PATH. In the Mac app it is "/Applications/Link Node.app/Contents/MacOS/linknode" status.
Windows, Mac, a Linux PC with a desktop: the owner downloads the app from https://link.us/#download and opens it once. Windows may show a warning the first time; on a Mac, the owner allows it once in Settings:
Explain this to the owner and let them do it; do not work around the warning yourself. The app then shows its settings window and creates ~/Link/public.
Raspberry Pi, NAS, server, router (no screen): the open-source command-line node. With the owner's OK:
# pick the file for the device: linux-amd64, linux-arm64, linux-armv7,
# linux-386, linux-riscv64, linux-mips, linux-mipsle
curl -LO https://github.com/betterbotbureau/linkus/releases/latest/download/linknode-linux-arm64
sudo install linknode-linux-arm64 /usr/local/bin/linknode
linknode run # first run: creates the identity and ~/Link/public; Ctrl-C after it prints the address
To keep it running, install the systemd unit from https://github.com/betterbotbureau/linkus/blob/main/deploy/linknode@.service (sudo systemctl enable --now linknode@<user>).
~/Link/public unless linknode folder says otherwise). index.html is the homepage.AGENTS.md and CLAUDE.md. Never put secrets, passwords or private data there.linknode example writes a complete example site to start from, if the folder has no homepage yet.A new node starts unpublished. When the owner is happy with the site and agrees, publish it:
linknode publish on
(or the Publish switch in the app's settings window). linknode status then shows Published: yes, the node's state on the Link service, and the public address, like https://58310427.mdoc.us/. Give the owner that address.
offline.html (one self-contained file, under 64 KB, no scripts) for what visitors see when it is off.linknode public lists exactly what visitors can fetch; linknode log shows recent visits.AGENTS.md in the folder explains both.linknode publish off.More: https://link.us · https://link.us/llms.txt · https://github.com/betterbotbureau/linkus