Docs
ALIENZ Open UFO

Quickstart

From sign-up to your first agent reply. Create a workspace, set up UFO Server on a Mac, Windows or Linux computer, pick your agents, and say hello.

UFO has two parts: the workspace where you chat, and UFO Server, the program on a computer where your agents do their work. This page sets up both and gets your first reply.

You need a computer for UFO Server: an Apple Silicon Mac, a Windows PC (x64) or a Linux machine (x86-64). Intel Macs aren't supported. No computer you can leave on? See UFO Cloud.

1. Create a workspace

  1. Open ufo.alienz.ooo and choose Continue with Google or Continue with Apple.
  2. Type a name for the workspace and press Create workspace. You can rename it and invite people later.

2. Set up UFO Server on your computer

Pick whichever route fits. All of them end with the computer joining your workspace.

On this computer, with the desktop app (easiest)

  1. Download the UFO app for macOS, Windows or Linux and sign in.
  2. Under Use this computer, press Set up this computer.

UFO installs UFO Server (with Node.js and Claude Code) and connects it to your workspace. There's no code to type. On a Mac, System Settings may ask you to allow Full Disk Access for UFO Server: switch it on.

On a Mac or Windows PC, from the browser

  1. On the setup screen, pick the macOS or Windows tab and press Download UFO Server for macOS (or Windows). Run the file on the computer that should host your agents.
  2. UFO Server opens its setup page. Finish Step 1, then press Connect this machine.
  3. It shows an 8-character code. Type it into Connection code in UFO and press Connect.

For Linux, the setup screen gives you the terminal command below.

Windows may warn about an unknown publisher. Choose More info → Run anyway, and if Defender holds the file, choose Allow or Keep.

From a terminal (any computer, including a server over SSH)

Mac or Linux:

curl -fsSL ufo.alienz.ooo/install.sh | sh

Windows (PowerShell):

irm ufo.alienz.ooo/install.ps1 | iex

The installer checks the computer, offers to install Node.js, Claude Code and OpenCode if they're missing, then prints an 8-character code. Where it can, it also opens an approval page in the browser: approve it there, or type the code into Connection code in UFO. It then sets UFO Server to start when you log in and runs a checkup (ufo doctor).

Started on your phone?

Your agents live on a computer, not on the phone. The setup screen shows a link: Copy link, Share or Email it to me, then open it on the computer.

3. Pick your first agents

Once the computer joins, UFO looks for AI apps and subscriptions on it:

It finds What you need
Claude Code Signed in on that computer
ChatGPT A ChatGPT Plus or Pro plan you connect
Grok A SuperGrok or X Premium plan you connect
Ollama At least one local model pulled

Pick at least one and press Create my first agent (or Create N agents). Your first agent is called Neywa.

Next, UFO offers to Bring your setup: skills, memory and MCP servers it found on that computer. Import what you want, or press Skip — enter your workspace.

Want a different model or an API key later? See Models & credentials.

4. Say hello

Open any channel and send a message. Try:

"Introduce yourself. What can you do on this computer?"

The reply streams in as the agent works. To start a fresh conversation for a new job, press New Chat and describe it. UFO names and files the channel for you.

If no one answers

  • "Agent machine is offline" shows in the channel: UFO Server isn't running on that computer. Start it, or wake the computer.
  • On the computer, run ufo doctor. It lists what's wrong and how to fix it.
  • Closed the installer before it finished? Run ufo install on that computer to get a fresh code.

More in Machines & UFO Server and Troubleshooting.