Building Apps

Tell your agent what to build. It scaffolds the project, installs deps, starts a dev server, and opens a live preview. Works with the built-in agent or any CLI agent running in the terminal.

App Lifecycle

The built-in agent uses create_app to register apps on the desktop. It auto-detects the framework and injects the correct port/host flags:

• Vite: --port $PORT --host 0.0.0.0
• Next.js: -p $PORT -H 0.0.0.0
• Flask/FastAPI: --port $PORT --host 0.0.0.0
• Express: reads process.env.PORT

Ports are auto-assigned from a pool (3101–3199). No port conflicts, no configuration.

Apps show a green dot on their desktop icon when running. Click the external link icon in the preview to open in a new tab.

Sharing

The browser tab URL is shareable. Anyone with the link can view your running app.

Caveats:

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

For permanent URLs, deploy to Vercel, Netlify, or any hosting provider.

CLI Agents

If you're using Claude Code or another CLI agent from the terminal, apps work the same way. Your agent starts a dev server, and you access it through the Remote Desktop browser or via the machine's proxy URL. The Versors desktop will detect running servers and show them as app icons.