# Sophon

> Sophon is an iOS chat app for your own agents. Run an agent on your machine, connect it through OpenClaw or a custom bridge, then chat with it from your phone.

## What Sophon is

Sophon is an iOS chat app for personal agents. Users run their own agent on their own machine and pair a small bridge process with the Sophon Cloud account on their phone. The bridge holds a long-lived WebSocket open and translates between the agent and the Sophon Agent Protocol (SAP) — a snake_case JSON wire format with REST + SSE for iOS and REST + WebSocket for the bridge. The reference connector is OpenClaw (`npx @sophonai/openclaw`); custom connectors authenticate with `inst_<id>:s_<env>_<secret>` bridge tokens issued at pairing and call `/v1/bridge/sendMessage`, `sendMessageDelta`, `sendMessageEnd`, `createTask`, `updateTask`, `finishTask`, and `requestApproval`. Sophon does not host a marketplace and does not run user agents — it only relays events between the phone and the machine the user already controls.

## Documentation

### Get started
- [Introduction](https://docs.sophon.at/)
- [Quickstart](https://docs.sophon.at/quickstart/)
- [Concepts](https://docs.sophon.at/concepts/)

### Protocol
- [Overview](https://docs.sophon.at/protocol/)
- [Connection lifecycle](https://docs.sophon.at/protocol/connection/)
- [Streaming model](https://docs.sophon.at/protocol/streaming/)
- [Tool calls & approvals](https://docs.sophon.at/protocol/tools-and-approvals/)
- [Wire reference](https://docs.sophon.at/protocol/wire/)
- [Errors & rate limits](https://docs.sophon.at/protocol/errors/)
- [Idempotency & resume](https://docs.sophon.at/protocol/idempotency/)
- [Observability](https://docs.sophon.at/protocol/observability/)

### Connectors
- [OpenClaw bridge](https://docs.sophon.at/connectors/openclaw/)
- [Write your own connector](https://docs.sophon.at/connectors/custom/)

### Reference
- [Changelog](https://docs.sophon.at/changelog/)
- [Glossary](https://docs.sophon.at/glossary/)
- [llms.txt](https://docs.sophon.at/llms.txt)

## Optional
- [Full snapshot (single file)](https://docs.sophon.at/llms-full.txt) — every doc page concatenated for easy paste-into-AI.
- [SAP RFC (normative spec)](https://github.com/serafimcloud/s-chat/blob/main/docs/SAP_RFC.md) — the source of truth these docs are derived from.