Docs / CLI reference

CLI reference

Nine commands, and most of them take no options at all. This is what termlink help prints, with what each one actually does.

termlink            Share this terminal (default)
termlink claude     Share this terminal with Claude Code already running
termlink client     Connect to one of your terminals from the CLI
termlink login      Sign in with Google
termlink logout     Sign out
termlink whoami     Show the signed-in account
termlink devices    List or sign out the machines on this account
termlink update     Update to the latest version
termlink help       Show this help

termlink

Share the terminal you are in. This is the one you will use most, and it has no subcommand — just the word on its own.

The machine registers under your Google account by dialing out, and from then on the session is reachable from the web client. Leave the terminal open — the session ends when the process does.

termlink claude

Share a terminal that already has Claude Code running in it, rather than starting from a fresh prompt.

termlink client

Connect to one of your own terminals from another terminal, instead of from a browser. It shows a picker with each session's working directory and host OS.

termlink login

If the machine is already enrolled it tells you so:

Already logged in: Your Name <you@example.com>
This machine is enrolled, so signing in again is not needed.
To log in with a different account, run `termlink logout` first.

On a headless machine, follow the URL it prints from whatever device you are sitting at.

termlink whoami

Print the signed-in account. Useful on a shared box before you share a terminal from it.

termlink devices

List the machines enrolled on this account. This is the one command that takes options.

termlink devices -revoke <id>   sign out one machine by id (from the list)
termlink devices -revoke-all    sign out every machine, including this one

-revoke-all includes the machine you are typing on, so you will be signing yourself out too.

termlink update

Pull and verify the latest release in place. This is why you only do the download-and-unblock dance once — installing covers that first time.

termlink logout

Sign this machine out. Run it before enrolling under a different account.

Two messages that confuse people

Most subcommands take no flags at all, so passing one — including --help — is an error rather than a help request:

termlink claude takes no options (got "--help")

Run termlink help instead. And a mistyped subcommand prints this before the command list:

unknown command "bogus"

The usual cause is looking for a subcommand that shares a terminal. There is not one — it is bare termlink.

Which version am I on?

Every run prints a banner with the version and the commit it was built from, which is worth quoting if you report something:

termlink v0.1.2-rc (baab7fe) — share a terminal, from anywhere

Checked against a running binary on August 25, 2026.

Next: sessions and limits, Auto-Yes, or troubleshooting if something is already wrong.