The Machine

Everything about how a Versors machine works: filesystem, interfaces, app system, lifecycle, and the tools available to you and your agent.

Filesystem

Your machine has a persistent Linux filesystem. The key directory is:

/home/user/desktop/

Files saved here appear as icons on the client-side desktop. This is where your agent saves output by default: PDFs, images, apps, data files. The entire /home/user/ volume persists even when the machine is off.

You have full sudo access. Install anything with apt-get, pip, or npm. Installed packages persist.

Two Interfaces

Client-side Desktop

The default view when you open a machine. A fast browser-native interface built in React. Includes:

• File explorer. Browse, create, rename, delete, drag-and-drop upload.
• Code editor. Syntax highlighting, multi-tab, edit any file.
• Chat panel. Talk to the built-in Versors agent, switch models, manage conversations.
• Terminal. Full bash terminal in the browser.
• App previews. Live preview of running web apps with hot reload.
• Document viewer. PDFs, DOCX, XLSX, CSV, markdown.
• Media player. Images, audio, video.
• Remote Desktop. Opens the full Linux display (see below).

This is fast and works well on phones and tablets. Most of your interaction happens here.

Remote Desktop (Full Linux Display)

Open the Remote Desktop window from the client-side desktop to see the actual XFCE Linux display running on your machine. This is the same screen your AI agent sees and controls.

Use this when you need to:

• Watch your agent operate Chrome in real-time
• Debug visual/UI issues in a running app
• Run desktop applications (VS Code, etc.)
• See exactly what GhostPilot is doing

The display runs at 1280x720 by default.

GhostPilot

GhostPilot is how your AI agent drives the Linux desktop. It can take screenshots, find buttons and UI elements, click, type, scroll, and navigate, just like a human sitting at the computer.

You don't need to learn GhostPilot yourself. Just ask your agent to do things on the desktop and it uses GhostPilot automatically. For example, you can ask your agent to open Chrome and research a topic, fill out a form on a website, or take a screenshot of a running app. The agent handles the rest.

Apps

When the built-in agent or a Versors tool creates an app, it gets:

• Auto-assigned port from pool 3101–3199
• Framework detection. Vite, Next.js, Flask, Express, etc. Port and host flags are injected automatically.
• Desktop icon with a green dot when running
• Live preview in the client-side desktop
• Shareable URL. Open the app in a new tab and share the URL.

Apps started from CLI agents (Claude Code, etc.) in the terminal also work. The desktop detects running servers and shows them as app icons.

Sharing caveats:

• The shared URL exposes all apps on that machine's proxy. Be mindful of what's running.
• The machine must be on. After inactivity it turns off and URLs go down until you turn it back on.

Machine Lifecycle

Auto-off: Machines turn off automatically after a period of inactivity (configurable: 5min, 15min, 1hr, 4hr, or never). When off, you're not charged for compute.

Turning on: Opening your machine turns it on in about 30 seconds. All files, packages, databases, and running processes are restored.

Credits while on: Compute costs credits per hour based on machine size (Standard: 20/hr, Plus: 40/hr, Power: 80/hr). Storage costs 50 credits/GB/month, billed daily.

Zero credits: If your credits hit zero, running machines turn off. They come back when your daily bonus arrives or you buy more credits.

Machine Sizes

CPU and RAM can be changed anytime. Storage (3–50 GB) is set at creation and can be upgraded but not reduced.