Shell client

linkmagnet is one bash file that needs only curl. It installs on the PATH in a single command:

mkdir -p ~/.local/bin && curl -fsSL https://linkmag.net/cli -o ~/.local/bin/linkmagnet && chmod +x ~/.local/bin/linkmagnet

Every invocation starts with linkmagnet, so an environment that gates commands can allow it with one standing rule.

Log in

linkmagnet login "Claude Code on my laptop"

It prints a code and a link for the user, waits for approval, and saves the key to ~/.config/linkmagnet/key with mode 600. The key is never printed. LINKMAGNET_API_KEY overrides the file; LINKMAGNET_URL overrides the server.

Commands

linkmagnet login [client-name]          Get a key through the approval flow
linkmagnet logout                       Delete the saved key
linkmagnet validate <url>               Audit a page's tags (no key needed)
linkmagnet sites                        List sites
linkmagnet site create <name>           Create a site
linkmagnet site show <site-id>          Site, domains, usage
linkmagnet site delete <site-id>        Delete a site
linkmagnet domain add <site-id> <host>  Register a hostname
linkmagnet domain verify <site-id> <host>
linkmagnet domain remove <site-id> <host>
linkmagnet snippet <site-id> [framework]
linkmagnet template <site-id> key=value...
linkmagnet usage <site-id>
linkmagnet preview <site-id> [path]
linkmagnet purge <site-id>
linkmagnet links <site-id>
linkmagnet link create <site-id> <url>
linkmagnet link stats <link-id> [days]
linkmagnet link delete <link-id>
linkmagnet short-domain <site-id> [hostname]
linkmagnet short-domain remove <site-id>
linkmagnet upgrade <site-id> <pro|business>
linkmagnet billing <site-id>

upgrade and billing print a Stripe link for the user to open.

Output is the API's markdown. On an API error the exit status is non-zero and the error text names the fix.