Remote Access

🌐 Remote Access

🌐 English · 한국어

Access and control CLITrigger from anywhere via Cloudflare Tunnel. Browser notifications alert you when tasks or discussions complete, so you can walk away and come back.

---

Setup

# Install cloudflared
winget install cloudflare.cloudflared    # Windows
brew install cloudflared                  # macOS

# Set TUNNEL_ENABLED=true in .env, then:
npm run start:tunnel
# → Outputs https://xxxx.trycloudflare.com in the console

Or via the CLI:

clitrigger config tunnel on

The console prints an external URL like https://xxxx-xxxx.trycloudflare.com — open it from your phone, laptop, anywhere.

---

Route a named tunnel through your own domain (optional)

The default *.trycloudflare.com / *.cfargotunnel.com hostnames sometimes trigger the browser's "dangerous site" warning. Point a named tunnel at your own domain to inherit your domain's reputation and avoid it.

Either use the sidebar ⚙ → Tunnel settings modal (Tunnel Name + Custom Hostname), or the CLI:

clitrigger config tunnel hostname app.your-domain.com
cloudflared tunnel route dns <tunnel-name> app.your-domain.com   # one-time

The displayed URL becomes https://app.your-domain.com and reputation tracks your domain.

---

Browser notifications

Toggle the bell icon in the sidebar (persisted to localStorage). On first enable, the browser prompts for permission; if denied, the toggle shows a blocked tooltip. You'll get an OS-level notification when a long task or discussion completes or fails.

---

Security note

Anyone with the password can control CLITrigger and run your Favorites tools. When exposing via tunnel, use a strong password and be mindful of what external tools you've registered. External sharing stays paused until first-launch setup completes, so the first user is guaranteed to be you.