Skip to content

Cassiiopeia/projectops / plugins/projectops-extras/skills/pro-remote-link

pro-remote-link

Verified

Give one link to open a desktop agent app (Orca, Paseo) on this computer from outside: Orca through a cloudflared quick tunnel and its saved pairing link, Paseo through its relay pairing link. Use for 'Orca link', 'Orca URL', 'Orca tunnel', 'Paseo link', 'remote link', 'open from outside'.

scripts/tunnel/state.py

View on GitHub
"""State folder ~/.projectops/remote-link: per-port tunnel records, logs, saved app links, harness overrides (shared across accounts and sessions)"""
from __future__ import annotations

import json
import os
import time
from pathlib import Path

# One place under the user home so every account and session sees the same records (folder = skill name)
STATE_DIR = Path(os.environ.get("PROJECTOPS_REMOTE_LINK_DIR") or Path.home() / ".projectops" / "remote-link")
STATE_FILE = STATE_DIR / "state.json"
PAIRING_FILE = STATE_DIR / "orca-pairing.json"
# Local harness copies: {STATE_DIR}/harness/{app}.md wins over the bundled harness/{app}.md
HARNESS_OVERRIDE_DIR = STATE_DIR / "harness"


def ensure_dir() -> Path:
    STATE_DIR.mkdir(parents=True, exist_ok=True)
    return STATE_DIR


def load() -> dict:
    try:
        data = json.loads(STATE_FILE.read_text(encoding="utf-8"))
    except (OSError, ValueError):
        return {"tunnels": {}}
    if not isinstance(data, dict) or not isinstance(data.get("tunnels"), dict):
        return {"tunnels": {}}
    return data


def save(data: dict) -> None:
    ensure_dir()
    temporary = STATE_FILE.with_suffix(".tmp")
    temporary.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
    os.replace(temporary, STATE_FILE)


def remember_tunnel(port: int, pid: int, url: str | None, log_path: Path) -> None:
    data = load()
    data["tunnels"][str(port)] = {"pid": pid, "url": url, "log": str(log_path), "started": int(time.time())}
    save(data)


def forget_tunnel(port: int) -> None:
    data = load()
    if data["tunnels"].pop(str(port), None) is not None:
        save(data)


def log_path_for(port: int) -> Path:
    return ensure_dir() / f"cloudflared-{port}.log"


def remember_value(key: str, value) -> None:
    data = load()
    data[key] = value
    save(data)


def write_private(path: Path, text: str) -> None:
    """Save as an owner-only file (the pairing code is an access key)"""
    ensure_dir()
    temporary = path.with_suffix(".tmp")
    descriptor = os.open(temporary, os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
    with os.fdopen(descriptor, "w", encoding="utf-8") as handle:
        handle.write(text)
    os.replace(temporary, path)
    try:
        os.chmod(path, 0o600)
    except OSError:
        pass
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall