Skip to content
setu

Setu docs

Setu is your browser bridge to Claude Code. Use this page to set up sign-in, run chat, share your screen, and link Telegram or WhatsApp channels.

Overview

Use Setu when you want one workspace where browser chat with Claude Code and live screen workflows stay connected.

  • Chat: ask directly in the browser at /chat, continue existing threads, and attach images.
  • Screen sharing: choose full-control desktop hosting (/stream) or browser-based view-only hosting (/b-host and /b-stream).

Want to publish to LinkedIn, Instagram, Threads, or YouTube? That lives on a separate companion app at sandesh.devfrend.com — same sign-in, dedicated composer at /dashboard/publish.

Sign in

Setu has its own sign-in surface. Create an account or sign in with email and password.

  1. Open /signup to create an account, or /login if you already have one.
  2. Confirm your email if you used password sign-up.
  3. Continue to /chat or any other dashboard page.

Chat

Open /chat to work in the main chat surface. You can also open /new to force a fresh thread.

  1. Start or select a thread in the left rail.
  2. Send text, then wait for the assistant stream/final response.
  3. Use image attachments when needed; they are persisted with the message row.

Thread source values used by Setu are website, mcp_relay, whatsapp, telegram, and claude_ai_log.

Legacy docs or links may still mention /dashboard/chat; on the current route map, the page is at /chat.

Screen sharing

Setu Desktop Host (Electron)

Use the desktop host when you need full remote control with trackpad + keyboard. The viewer page is /stream.

  1. Install and run Setu Desktop Host on your machine.
  2. Start a host session from the desktop app.
  3. Open /stream in Setu to view and control that machine.

Current platform support is macOS only.

Browser-based host

Use the browser host when you want no install and view-only streaming.

  1. On the machine you want to share, open /b-host.
  2. On the viewer side, open /b-stream.
  3. Keep both tabs active while sharing.

Telegram

Setu supports one Telegram bot per user using your own BotFather token.

  1. Create a bot via @BotFather using /newbot.
  2. Open /settings/channels in Setu.
  3. Paste the token in the Telegram section and click Add Bot.
  4. Click Get start link, open the deep link in Telegram, then tap Start.

WhatsApp

Setu can route WhatsApp through the Setu Desktop Host using Baileys with a paired self-chat session. Setup starts on /settings/channels.

  1. Open Setu Desktop Host and pair your WhatsApp session there.
  2. Open /settings/channels in Setu and generate a one-time link phrase.
  3. Send the phrase from your WhatsApp client as instructed.
  4. After pairing, Setu routes outbound replies through the desktop Baileys bridge.

Setu receives inbound Baileys messages via /api/channels/whatsapp/baileys/inbound and host status via /api/channels/whatsapp/baileys/status.

For internal architecture, see the project README on GitHub: apps/setu/CLAUDE.md.