Skip to main content

Extensions and Plugins

Raycast Extension

Use pinakea Browser access from Raycast

pinakea 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 pinakea over a loopback-only connection (no browser access needed)
  • Remote Mode (different Mac): talks to pinakea via Browser access

This can make it faster to:

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

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

red_distortion_4

Set scope

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

Prerequisites

  • Raycast installed
  • pinakea installed

For Local Mode:

  • pinakea must be running on the same Mac

For Remote Mode:

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

If pinakea 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 pinakea 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 pinakea App (and Open Search in pinakea App). If pinakea is not running, the launch action is Open pinakea App.

Remote Mode (different Mac)

  1. Enable browser access in pinakea (see Browser access).
  2. Set a Server password in pinakea (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 pinakea Settings)
    • Enter the Server password

Troubleshooting

  • Local Mode says offline: make sure pinakea is running on the same Mac.
  • Remote Mode says offline: verify Enable Browser Server is on in pinakea 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 pinakea and both devices are connected in Tailscale.