The console and the naetive command

Last reviewed: 16 Sep 2026

Two small things the installer puts on your machine.


The console

The console is a small program that runs on your computer (port 4000) and powers the Terminal page: when you start an agent there, the console runs the real process locally and streams it to your browser. You only need it for the Chats page; connecting a chat agent does not.

Start it with:

~/.naetive/start-console.sh

It binds to your own machine only and answers only to the platform that installed it (a per-install secret), so nothing else on your network can reach it.

The naetive command

naetive export [--project <slug>] [--dry-run]

Run inside a repository to write its .naetive folder from the committed understanding. The project slug is the part after /p/ in the Naetive address bar; a repository can pin it so you never pass it again. Your key is read from where the installer put it, never from the command line. See The folder.

Where things live

  • ~/.naetive/: the console, the tunnel launcher, the hooks and the files behind the naetive command (the command itself is at ~/.local/bin/naetive).
  • ~/.claude/: your key file, readable only by you, and Claude Code's own settings, where the installer registered the hooks.
  • A repository's .naetive/ folder and its .claude/naetive.json project pin, when you asked for the folder.

Nothing here needs reading; it is for when you want to know where a thing is. Uninstall removes all of it, including the connection: the uninstall script the installer left next to your key file, also shown under Install on Connect.