Skip to main content

Usage

Raycast Extension - ONA.UNO Docs

Use ONA.UNO Web 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 Web Access needed)
  • Remote Mode (different Mac): talks to ONA.UNO via Web 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:

  • Web Access enabled in ONA.UNO (Settings → Web Access)
  • A Web Access 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, …).

Remote Mode (different Mac)

  1. Enable Web Access in ONA.UNO (see Web Access).
  2. Set a Web Access password in ONA.UNO (Settings → Web Access).
  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 Web Access password

Troubleshooting

  • Local Mode says offline: make sure ONA.UNO is running on the same Mac.
  • Remote Mode says offline: verify Enable Web Server is on in ONA.UNO and that the Status section shows URLs.
  • Auth fails (Remote Mode): confirm the password in Settings → Web Access 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.