Skip to main content

Usage

Raycast Extension - ONA.UNO Docs

Use ONA.UNO Server browser access from Raycast

ONA.UNO can be used with a Raycast extension that lets you search, open items, and clip URLs directly from Raycast.

It supports two connection modes:

  • Local Mode (same Mac): talks to ONA.UNO over a loopback-only connection (no browser access needed)
  • Remote Mode (different Mac): talks to ONA.UNO via Server browser access

This can make it faster to:

  • Search your items from the Raycast launcher
  • Open recent items quickly
  • Clip a URL into ONA.UNO
Note

Raycast extensions are separate from the ONA.UNO app. Setup and availability may vary depending on how you installed the extension.

red_distortion_4

Set scope

The Raycast extension operates on ONA.UNO’s currently selected Set. It can’t switch Sets remotely — switch Sets in ONA.UNO first. See Sets (Libraries).

Prerequisites

  • Raycast installed
  • ONA.UNO installed

For Local Mode:

  • ONA.UNO must be running on the same Mac

For Remote Mode:

  • Browser access enabled in ONA.UNO (Settings → Server)
  • A Server password set (used by the extension)

If ONA.UNO runs on a different Mac, you also need network access to that Mac:

  • Same local network (Wi‑Fi), or
  • Remote access via Tailscale

Setup (typical)

Local Mode (same Mac)

  1. Make sure ONA.UNO is running.
  2. In Raycast → Extension Settings, set Connection Mode to Local Mode.
  3. Use the Raycast commands (Search, Recent Items, Clip URL, …).
Info

In Local Mode, app-target actions are labeled Open in ONA.UNO App (and Open Search in ONA.UNO App). If ONA.UNO is not running, the launch action is Open ONA.UNO App.

Remote Mode (different Mac)

  1. Enable browser access in ONA.UNO (see Server browser access).
  2. Set a Server password in ONA.UNO (Settings → Server).
  3. In Raycast → Extension Settings:
    • Set Connection Mode to Remote Mode
    • Set the server URL (one of):
      • Local network: http://192.168.x.x:8080
      • Remote (Tailscale): http://100.x.x.x:8080 (you can use Copy Tailscale URL in ONA.UNO Settings)
    • Enter the Server password

Troubleshooting

  • Local Mode says offline: make sure ONA.UNO is running on the same Mac.
  • Remote Mode says offline: verify Enable Browser Server is on in ONA.UNO and that the browser-access status section shows URLs.
  • Auth fails (Remote Mode): confirm the password in Settings → Server and update it in Raycast.
  • Tailscale URL doesn’t work: ensure Enable Remote Access (Tailscale) is enabled in ONA.UNO and both devices are connected in Tailscale.