Setting up this computer
Last reviewed: 28 Oct 2026
One line in a terminal sets a computer up for Naetive. Everything else on this page is optional and can be added later from Connect. The page says what each piece is for, how to turn it on, and what to do when it stops.
Setup belongs to the computer and the browser you are using. A computer set up elsewhere does not make this one ready.
The one thing most people need: the install line
On Connect, paste the one line for your computer into a terminal, from any folder. macOS, Linux, WSL:
curl -fsSL https://naetive.ai/install | bash
Windows (PowerShell):
irm https://naetive.ai/install.ps1 | iex
It installs Claude Code if it is missing, the Naetive connection for it, the console, the tunnel and the naetive command. The browser opens and asks you to approve the computer, once; after that the installer finishes by itself and prints what it set up.
That is all Claude Code needs. Open it in any folder and it knows which project it is (on Windows, which has no hooks yet, tell it the project once; see Connecting Claude Code): the computer remembers links, a folder whose git repository matches a project is linked by itself, and if it cannot tell, Claude asks once and remembers. After install, Naetive starts by itself when you log in. You don't keep any window open. A background service on this computer starts the console and, once you share a project, the tunnel, brings them back after a crash, and updates everything (the command, the hooks, the console and the tunnel) by itself. On Windows with WSL that service starts from a shortcut in your Windows Startup folder. Two exceptions: on Linux without a systemd user session nothing starts at login (the installer says so; start it yourself with ~/.naetive/start-all.sh), and on Windows without WSL you start the tunnel yourself.
Giving a project its folder
A project's folder is decided when you create it. Project switcher, New project, name it, then choose one of:
- Start new: Naetive makes an empty folder at
~/projects/<name>on this computer and links it. - Bring existing code: it lists the folders on this computer that match the project (its git repository, or its name), or you type the path if the folder is called something else. This browser must be paired with the computer (Chats and file access, Pair this browser); otherwise the project is created and the folder follows from Connect.
- Plan first: no folder yet.
A checkbox, off by default, Let ChatGPT and Claude on the web reach this folder, is the only thing that gives those agents access to files. Your files stay on your computer; agents read them only when you ask.
This needs the tunnel running on this computer and this browser paired with it (below). If no computer is connected, the project is still created, and the folder can be given from Connect later.
The extras
Files for ChatGPT and Claude on the web
Those agents reach your files only through the tunnel, and only for projects you shared: the checkbox at creation, or on an existing project the one line naetive share --project <name> on this computer. Then start the tunnel from any folder: ~/.naetive/start-tunnel.sh (Windows: & "$env:USERPROFILE\.naetive\start-tunnel.cmd"). Your files stay on your computer; what an agent asks for travels to it, encrypted, when you ask it something. Details: Sharing your projects and starting the tunnel.
Chats in the browser
The Chats page opens a terminal on this computer in a browser tab. It needs two things:
- The console, which the install line started. It starts at login and comes back after a crash, from install on: on macOS, on Linux with a systemd user session, and on Windows. Stop it with
~/.naetive/start-console.sh --stop(Windows:start-console.cmd --stop), and a stop stays stopped. On Windows with WSL, the Startup shortcut starts it when you log in to Windows (its window starts minimised; leave it open;~/.naetive/start-all.sh --no-login-startturns that off). On Linux without systemd it runs until you log out and you start it again with~/.naetive/start-console.sh. - This browser paired with the computer, once. On Connect, open Chats and file access, then Paired browsers, Pair this browser. The page shows a code, and a Naetive box opens on the computer: check it names this browser, type the code there and press Pair (Not me if you did not ask). Where no box can show, run
naetive pairon the computer instead. Pairing is with the computer, whichever project's page you are on. Revoke a browser from the same place.
Commands
Agents cannot run commands on this computer until you say so: naetive commands on, then confirm in your browser. naetive commands off, or Turn off on Connect, ends it. Commands run as you.
Reading Connect
The card at the top says who is here now. Under it is this computer's row: Console on, Files ·
Red appears at the top only when something you set up has stopped, with the one line that fixes it: naetive fix for either, or for the console ~/.naetive/start-console.sh --keep-running and for the tunnel ~/.naetive/start-tunnel.sh. An extra you never turned on is grey, never red. A red count on Connect in the side navigation shows from any page when something on this computer has stopped.
If it does not work
- The terminal shows why the install stopped. Run it in a terminal, not by double-clicking a file. The installer installs Node for you if it is missing. On Windows, the
irm … | iexform needs no policy change. - The approval expired: approval codes last ten minutes. Run the install line again for a fresh one. "Using the key already on this machine" (on Windows, "computer") on a re-run is the normal line.
- "This machine's key is no longer valid": you regenerated your key. Run the install line again.
- The console stopped:
naetive fix, or~/.naetive/start-console.sh --keep-running. - Something stopped, or you are not sure what runs: on macOS, Linux and WSL,
naetive fixrestarts whatever of Naetive stopped on this computer and checks its key, andnaetive statussays what runs and whether it starts by itself at login.
Taking it off
See Removing Naetive from a computer. The uninstaller tells Naetive the computer is gone (its console and its browser pairings), and within a minute Connect shows nothing installed on this computer.