# Pair a device

> Install the linefold CLI so coding agents run their sessions on your own computer.

Source: https://docs.linefold.app/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`).

```sh
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.