Docs
ALIENZ Open UFO

Terminal & files

Open a shell on the machine your agents run on from anywhere, and browse, search, preview, edit, upload and download that machine's files.

Sometimes you want to reach into the machine yourself — read a log, fix one line in a config, grab a file an agent made. UFO gives you a terminal and a file browser for the machine your agents run on, from a browser, the desktop app or your phone.

Open a terminal on the machine

The terminal is for the workspace owner only, and it's off until the owner turns it on.

  1. Open Settings → Machine.
  2. On the machine's card, switch on Web terminal (Lets the workspace owner open an interactive shell on this machine).
  3. Press Terminal on the left bar.

A shell opens on the machine, under the same user account UFO runs as there. Use it like any terminal: check a log, restart a service, edit a file.

Leave it running or end it

You want to Do this
Put it away and keep the shell running Press × (Hide (session keeps running)). Press Terminal again to come back to it.
End the shell Press Disconnect

If it does not open

What you see What to do
Only the workspace owner can open a terminal. Ask the owner, or ask an agent to run the command for you.
Terminal is disabled for this machine Switch on Web terminal in Settings → Machine.
No Terminal button The workspace has no machine yet — see Machines.

Browse the machine files

  1. Press Drive on the left.
  2. Open the tab with the machine's name (next to Cloud Drive).

You see the machine's folders as they are right now. Nothing is copied anywhere just because you looked. Anyone in the workspace can browse here while the machine is online.

Find your way around:

  • Places: Home, Recently changed (files changed in the last 14 days, newest first) and Trash.
  • Back, Forward and Up (Alt+←, Alt+→, Alt+↑). Click the path bar to type a path.
  • My bookmarks and Shared bookmarks — right-click a file or folder and choose Bookmark (only you see it) or Shared Bookmark (everyone in the workspace sees it).
  • Sort by Name, Date modified, Size or Type; switch Grid view and List view; show hidden files; open the preview pane.

Choose which folders are shared

The machine shares its home folder. To add another place — an external drive, say — the workspace owner opens Settings → Machine → Shared folders, types the folder's full path and presses Add. Remove takes it off again. Everything else on the machine stays out of reach.

Search the machine files

Type in the search box (Search file names…). Press Contents to also search the text inside files, in this folder and below. Clear goes back to the folder.

Preview and edit a file

Click a file to open it:

  • Images, video, audio and PDFs show right there.
  • Text and code open in an editor. Press Edit, make your change, then Save.
  • On an image, AI Edit opens the image editor.
  • Download saves a copy to your device.

Download files

Right-click a file and choose Download. For several items or a whole folder, choose Download as .zip, or Download files separately.

Upload and organize files

  • Upload → Files… or Folder… — or drag files from your computer onto the folder.
  • + File and + Folder create new ones.
  • Right-click for Rename, Cut, Copy, Paste into folder and Copy Path. Ctrl+V pastes too.
  • Delete moves items to the machine's trash. Open Trash to Restore them, or Delete permanently.

When a name already exists, UFO asks whether to Replace it or Keep both.

Hand a file to an agent

Right-click a file or folder and choose Add to chat. Its path goes into your message box — finish the message and send:

"Summarize the errors in this log."

When an agent mentions a file on the machine, the path shows as a link:

  • Click it: images open full size, text and documents open in a preview, folders open in Drive, and other files download.
  • Right-click it: Open in Drive or Download.

These files stay on the machine. They open only while the machine is online, and only as long as the file is still there. To keep one for good, ask the agent to "put it in Drive" — see where a file lives.