Adding machines

A hub reaches its own machine directly. Other machines join it, or it reaches them over SSH. Both start from Machines → Add machine.

#Laptops and desktops

Choose Run a command on it, name the machine, and tap Create pairing command. Pick macOS or Linux, or Windows, and run the one-line command it shows on that machine. The sheet waits with Waiting for the machine to connect… and then shows it.

The command downloads inyon from the hub, checks it against the hub's checksums, and installs it as a small user service that connects out to the hub. No sudo, no open ports on the machine.

• The command carries a token for that one machine. Treat it like a password until it's used.
• An unused command expires after 24 hours. New pairing command on the machine's page makes another.
• The machine needs to reach the hub's address. A plain http:// hub address is only accepted on a private network.

#Servers over SSH

Choose Reach it over SSH and give it user@host or an alias from the hub's ~/.ssh/config, plus a port and a key file if needed. The server only needs tmux and your agents.

The hub uses the system ssh with your config, keys and jump hosts, and stores no keys of its own. The first connection to a new server accepts its host key and remembers it in ~/.ssh/known_hosts; a key that changes later is refused. Connections are reused for ten minutes, so opening sessions is quick.

#The machine's page

Tap a machine for its page. New session, Rename and Remove are at the top. Removing a machine never touches it: Its tmux sessions keep running on the computer.

The tabs:

• Sessions: its tmux sessions and panes.
• Setup: what it has and what it's missing (below).
• Config: each agent's config files, editable, with JSON checked before saving and the last five versions kept as backups.
• Uploads: how much space uploaded files take, with buttons to clean older ones or delete them all.
• Integration: Inyon's optional Claude Code integration, and which agents are signed in.

#The Setup tab

It checks the machine and fixes what it can:

• tmux, and a tmux session to work in (it can keep one called main running).
• Node.js, needed for the agents installed through npm (Codex, Gemini CLI and GitHub Copilot).
• Each agent: installed or not, its version, whether it's signed in, and from 0.17.4 whether it's up to date: the row says up to date, or shows Update to 0.50.0 when a newer version is on npm.

Install uses the agent's official installer, or npm when there isn't one. Fixes run with the machine's package manager (apt, dnf, yum, pacman, apk, zypper or Homebrew); when one needs your password, the tab shows the command to run yourself instead.

Update runs npm install -g <package>@latest when the agent came from npm (or npm install --prefix <folder> when it sits in a folder of its own, so the copy on your PATH is the one that changes), otherwise the agent's own updater (claude update, codex update, opencode upgrade, copilot update, agy update); Gemini CLI has none, so it's installed again from npm. Antigravity CLI isn't on npm, so Inyon can't tell whether it's behind; its row offers a plain Update that runs agy update. The hub asks npm for the newest versions at most once an hour, and when it can't reach npm the rows just show the installed version.

When an install or update fails, the row opens with the likely cause (npm can't write to its folder, no Node.js, no network), the last lines of what the step printed, the command to run on the machine yourself with a copy button, and a link to the agent's install guide. The version shown comes from the agent itself after the step, so an installer that reports success without installing anything still counts as a failure.

Sign in runs the agent's own sign-in in a hidden tmux session and turns it into steps: a code to copy, a page to open, a menu as buttons, or a box to paste a code into. Closing the sheet stops it.

#The Claude Code integration

Turning it on gives Inyon exact session matching and live numbers (context, cost, limits) for Claude Code. It adds a small hook script and wraps your status line, backing up ~/.claude/settings.json first, and turning it off puts everything back. Security lists every file.

When a new version of Inyon changes these scripts, it updates them on the machine by itself, as long as it has seen the integration on there before. Otherwise the button says Update instead of Turn on. From 0.17.1, an older copy of Inyon (a phone that hasn't updated yet) leaves scripts from a newer one alone.

#When a machine goes offline

The hub keeps the last thing it saw. After a minute away, the machine shows as Offline · last seen 5 min ago, with its sessions and recent conversations still readable, and you're notified. You can't send to it until it's back. When it reconnects you're told how long it was away, and a turn that finished while it was gone still counts as finished.

#Updating machines

A machine that joined the hub updates from its page under Machines, to the hub's own version. The hub sends a short script that checks the download first, so this works for any version.

#Removing a machine

Remove on its page disconnects it and revokes its token. From 0.16 the machine then leaves the hub by itself, as inyon disconnect would: it forgets the hub and removes its background service, so nothing starts it again. A machine that's off at the time does this the next time it starts. Its tmux sessions keep running, and Inyon stays installed; inyon uninstall removes it.

From 0.17, if the machine is online, the hub first takes back what it put there: the Claude Code and Antigravity integration, the uploads and the prompt log. For an SSH server it also closes the connection it kept open. See Security.

Before 0.16 the service kept starting it again, and it called the hub every 30 seconds. On a machine you removed before then, run inyon disconnect.