Machines

A machine is a server of yours (a VM, a Raspberry Pi, a spare computer) that runs a small Escanor agent. The agent connects out to Escanor, so you do not open any ports. Once connected, the machine appears in Machines in the apps and you can chat with it.

Connect one#

Follow Connect a VM. You need Linux with Node.js 20 or newer, git and systemd. The install command shows your hub address and secret already filled in.

What you can do#

• Chat with a machine: each chat is an independent Claude Code session with its own working directory and history. You can start new chats, search them and come back later.
• Choose how it works per chat: permission mode (default, auto, accept edits, plan, don't ask, bypass), model and reasoning effort. Changes apply immediately, even mid-session.
• Approve tool calls (running commands, editing files) from the chat or from your phone.
• Attach photos and text or code files.
• See which machines are online, and when an offline one was last seen.

If a VM has more than one Claude account set up, its chats are grouped by account.

Permissions#

By default Claude Code asks before it runs commands or edits files, and the app shows each request as an Allow or Deny card. The "bypass" mode skips every check; use it only on machines where that is acceptable. Read-only operations are allowed without asking.

Keeping it safe#

• The workspace folder is the configured working boundary; use an unprivileged OS account and independent isolation for sensitive work.
• Machines authenticate with a hub token stored in their configuration. Rotate it from Machines if it leaks.
• Disconnecting a machine removes it from your list; stop the service on the server to remove the agent itself.

Machines and Computers#

Machines are servers you own running the agent. Computers are your own computers running the Escanor desktop app, paired to your phone. They do different jobs, so they have separate lists; see Computers and pairing.