Link Node: instructions for AI agents

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.

1. Is Link Node already there?

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.

2. Install it

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>).

3. Build the site

4. Publish

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.

5. Good to know

More: https://link.us · https://link.us/llms.txt · https://github.com/betterbotbureau/linkus

This page as Markdownllms.txt