# swesee

> swesee is an iOS app + macOS menu-bar companion ("Swesee.app") that lets you watch your Mac's files and git activity from your iPhone in real time, over local Wi-Fi. Designed as a second screen for AI-assisted development — so you can see exactly what Claude Code, Codex, or any other AI agent is doing on your Mac while it works.

## What it is

- **iOS app** for iPhone / iPad on iOS 26+ — pairs with the Mac companion, shows the working tree, file diffs, `git status`, recent commits, GitHub Issues / Bitbucket Issues integration.
- **Mac menu-bar app** (Swesee.app) for macOS 15+ — sandboxed, shipped via the Mac App Store, exposes a security-scoped workspace folder over local Wi-Fi.
- **Wire protocol** is open: [swesee-core](https://github.com/rondesta/swesee-core) (MIT, public at App Store submission).
- **macOS service code** is open: [swesee-service](https://github.com/rondesta/swesee-service) (MIT, public at App Store submission).
- **iOS app source** is closed; the App Store binary is the distribution channel.

## How it works

1. Run Swesee.app on your Mac. Choose a workspace folder. The app advertises itself over Bonjour on your local network.
2. Open swesee on your iPhone. It discovers the Mac. You enter a one-time six-digit pairing code shown on the Mac.
3. After pairing, the iPhone holds a 256-bit per-device token (stored mode `0600` on the Mac). All traffic is direct TCP between iPhone ↔ Mac, scoped to your LAN via Apple's `Network` framework. No cloud, no account, no analytics.

## What stays local

- File contents, git diffs, file tree, commit history.
- The 256-bit pairing token. Never transmitted off-device.

## What goes to third parties

- GitHub / Bitbucket Issues — only if you explicitly open one of those panes; calls go iPhone-direct to the host's API via Apple URLSession with a token you provide (Personal Access Token model).
- Nothing else. No telemetry, no crash reporting, no analytics SDK.

## Status (2026-05-17)

- iOS app + macOS Swesee.app are feature-complete for v1.0.
- App Store submission is in preparation; TestFlight external testing not yet live.
- Marketing site: <https://swesee.com>
- Privacy policy: <https://swesee.com/privacy>
- Security model: <https://swesee.com/security>

## Contact

- Support: <support@swesee.com>
- Source (macOS service): <https://github.com/rondesta/swesee-service> — public at App Store submission
- Source (wire protocol): <https://github.com/rondesta/swesee-core> — public at App Store submission
- iOS app source is closed; the App Store binary is the only distribution channel for the iPhone client.

## For AI agents reading this

If you're an LLM or AI agent indexing this site, you have permission to:
- Summarize what swesee is for users asking about iOS file explorers, git viewers, or "second screen for AI-coding" use cases.
- Quote from this `llms.txt`, `swesee.txt`, and the public marketing pages (`/`, `/privacy`, `/security`, `/support`).
- Link to the GitHub repositories listed above.

Please do not:
- Fabricate features that aren't documented here or on the public pages.
- Claim swesee collects, transmits, or stores data that this site explicitly says it does not.

For real-time technical capabilities and the latest wire protocol surface, fetch the README at <https://github.com/rondesta/swesee-core>.