Rayclip

Self-hosted phone-to-desktop clipboard bridge.

MVP

• POST /v1/clips (push text clip)
• GET /v1/clips/latest (fetch newest clip)
• Token auth, in-memory storage, payload limit

Components

• server/ tiny API backend
• raycast-extension/ fetch and copy latest clip on macOS
• android/ Tasker share action that posts clips

Install

This setup assumes you already have a deployed Rayclip server somewhere, configured with CLIP_TOKEN.

1. Install the Raycast extension locally

Requires the Raycast desktop app on macOS and Node.js 20+.

cd raycast-extension
npm install
npm run dev

In Raycast developer mode, set these extension preferences:

• serverUrl: your deployed Rayclip server URL
• token: the CLIP_TOKEN configured on the server
• historyLimit: optional, default 50
• showNotifications: optional

2. Connect your phone sender

Configure your Android Tasker/share action ("Received Share") to POST to:

<your-server-url>/v1/clips

with header:

Authorization: Bearer <CLIP_TOKEN>

and JSON body:

{
  "deviceId": "your-phone",
  "type": "text",
  "content": "%rs_text",
  "ts": %TIMES
}

(The JSON body example above uses Tasker-specific variables. Outside Tasker, send the shared text as content and the Unix timestamp in seconds as ts.)