Quickstart

Two pieces make up UFO: your workspace (the website and apps) and the agent host (a small daemon on your own computer). This page gets both running.

#1. Sign up

Sign in at ufo.alienz.ooo and name your workspace. Every new workspace starts with Neywa, a default agent, so there's someone to talk to immediately.

#2. Install the agent host

The host runs on macOS (Apple Silicon), Linux (x86_64) and Windows (x64).

The easiest install is the app — download it for macOS, Windows or Linux and install it like any other program.

Prefer a terminal? The one-liner does the same job:

# macOS / Linux
curl -fsSL ufo.alienz.ooo/install.sh | sh

# Windows (PowerShell)
irm ufo.alienz.ooo/install.ps1 | iex

Either way, setup does the rest:

• detects Node.js and your engines (Claude Code, OpenCode) and offers to install anything missing
• pairs the machine with a short device code you approve in the browser
• sets the host to start automatically on boot
• finishes with ufo doctor — a health check that tells you exactly how to fix anything it flags

#3. Say hi

Open your workspace and send a message. Neywa is already in your channels, and the suggested first messages are a good place to start. The reply streams token-by-token from your own machine.

If Claude Code is signed in on that machine there's nothing to configure — Neywa just works. Want a different brain? See Models & credentials.

#Useful commands on the host

# check the host any time — prints the exact fix for anything it flags
ufo doctor

# manage the background service
ufo service status
ufo service install   # (re-)register auto-start

Updates are rolling and zero-downtime: the host upgrades itself in the background, and every new message is handled by the newest version. You never restart anything by hand.

#Where to go next

• Apps & devices — desktop apps, mobile, and the web workspace.
• Workspaces & channels — how conversations are organized.
• Troubleshooting — if anything above didn't go smoothly.