Pair a device

Coding agents run their sessions in an environment: a device you pair, or a cloud environment an admin sets up in Settings › AI & Agents › Coding sessions. A device needs macOS or Linux, Node 22 or later, and the agent CLIs you want (for example claude).

npm install -g @linefold/cli
linefold pair
linefold add ~/code
linefold service install

1. Install the linefold command.
2. pair opens Linefold: approve the code it shows.
3. add shares a folder (your home is shared already).
4. service install keeps it running in the background on a Mac (elsewhere: linefold start).

The device then shows under This device in Settings › Account › Environments, with these commands to copy.

• linefold status says whether it is paired and running.
• Run the install command again to update.
• Try it without installing: npx @linefold/cli pair, then npx @linefold/cli start.

The daemon keeps one outbound connection to Linefold: no open port, no tunnel. A session's Environment menu moves it to another device or environment.