# SantaClaude

SantaClaude (santaclaude.app) is a remote-control layer for Claude Code. It lets a person view and operate the Claude Code session running on their own computer from a web browser, desktop app, or mobile app.

## How it works
A connector runs on the computer where Claude Code is installed. It is distributed as the npm package `@cliphijack/santaclaude` and started with `npx`. The connector runs under the logged-in user's OS account and permissions, and maintains a connection to a Cloudflare Worker that relays terminal input/output between that computer and the user's other devices. The package is public on npm, so its source and network behavior can be inspected before or while running it (e.g. read the installed code under `node_modules`, or observe outbound connections with a network monitor).

## What it does
- Remote terminal: terminal input/output of a local Claude Code session is viewed and controlled from another device.
- Session queue: multiple Claude Code sessions on the same account are managed together, with each session's replies collected in one view.
- Notes: a session's reply or question surfaces as a note. In the web queue and desktop app these are movable, always-on-top windows the user replies in directly; the reply is routed back into that session. Notes from any entry point (queue, terminal, external) collect in one inbox.
- Notifications: replies are pushed to registered devices. On Android the notification supports inline reply and image preview from the lock screen; iOS supports inline reply (lock-screen image preview is not yet implemented).
- Voice: speech-to-text for dictating instructions and text-to-speech for reading replies.
- Scheduling: a session can be given recurring or one-off instructions in natural language (e.g. "every day at 9:00", "every 30 minutes", "tomorrow at 3pm"). This is handled by the bundled santa-schedule skill.
- Webhook ingestion (AutoTab): an external HTTP event (a payment, a form submission) can inject an instruction into a session.
- File transfer: files a session produces (images, audio, documents) are delivered to the user's devices; on the desktop app they open in the associated program.

## Bundled skills
When the connector starts, it installs a set of Claude Code skills into each connected project so the user's sessions can act on SantaClaude features and follow common workflows:
- santa-schedule (recurring/one-off scheduling by natural language), santa-show (send a file to the user's devices), santa-auto (register webhook entry points), santa-brain (query a knowledge base), santa-notion (Notion integration), santa-tailscale (large-file transfer over Tailscale).
- A bundled copy of the Superpowers workflow skills (brainstorming, writing-plans, subagent-driven-development, systematic-debugging, test-driven-development, and others) and a 51-skill marketing pack (SEO, ads, copywriting, email, CRO, analytics, and others).

## Desktop and mobile apps
- Desktop (Windows, macOS): an Electron app that loads the same queue. Reply notes appear as frameless, always-on-top windows that float over other applications on the desktop; the app auto-updates.
- Mobile (iOS, Android): the same queue in a native shell, with push notifications, lock-screen inline reply, microphone input, and file open.

## Data handling
The connector relays terminal input/output to the user's devices through the Cloudflare Worker. Conversation content, code, and files reside on the computer where Claude Code runs; SantaClaude's servers are not used to persist them. The connector is a public npm package, so a user can read its installed source or monitor its network connections to observe what is transmitted. Claude Code usage is billed by Anthropic under the user's own Anthropic account or API key.

## Platforms
Web (any browser), Windows and macOS desktop apps, and iOS and Android apps. All use the same account and see the same sessions.

## Typical use
Instructions run inside the user's own Claude Code sessions, so any task those sessions are set up to do can be scheduled or triggered remotely. Examples of how people use it:
- A session configured for writing is scheduled to draft a blog post every morning at 9:00, and the result is reviewed from a phone.
- A session that produces short-form videos is run on a schedule or fired by a webhook, and the output files arrive on the user's devices.
- Several agent sessions run at once (for example one coding, one researching, one drafting) and their replies are tracked in a single queue.
- An agent that hits a question mid-task notifies the user, who answers from the lock screen without returning to the desk.
- A payment or form submission triggers a session to run a follow-up task automatically.

## Setup
1. Open https://santaclaude.app/install and sign in with Google.
2. Run the shown `npx` connector command in the terminal on the computer where Claude Code runs.
3. Open https://santaclaude.app/queue on any device; the session appears there.

## Pricing
Free during open beta. An optional one-time PRO purchase (₩149,000, bound to the account) removes ads; it is available by card or bank transfer on web, desktop, and Android.

## Links
- Setup: https://santaclaude.app/install
- Web queue: https://santaclaude.app/queue
- Home: https://santaclaude.app/
- Connector package: https://www.npmjs.com/package/@cliphijack/santaclaude