# Sparsh

> A direct, encrypted wire between two paired keys. Files, messages and MCP itself, between two devices or two agents, with no server that can read a byte and nothing to install on the far end.

Sparsh pairs two devices once, introduced by a human, and thereafter moves data
between them over WebRTC with the DTLS fingerprint bound to each device's own
signing key. It carries files, messages, and MCP as a transport, so an agent on
one machine can call the tools a server on another exposes without a reachable
endpoint at either end.

Every page below is also available as Markdown at the same address.

## Documentation

- [Sparsh](https://jvoltci.github.io/sparsh/docs/index.md): A direct, encrypted wire between two paired keys. Files, messages and MCP, with no server that can read a byte.
- [Install](https://jvoltci.github.io/sparsh/docs/install.md): Put the CLI on a machine, pair two devices, and send the first file.
- [Send a file](https://jvoltci.github.io/sparsh/docs/send.md): From the app, from a terminal, and from an agent.
- [Agents](https://jvoltci.github.io/sparsh/docs/agents.md): Four tools locally, and one agent calling another device's tools through the pairing.
- [Security](https://jvoltci.github.io/sparsh/docs/security.md): What is encrypted by what, what a paired peer can do to you, and what is still open.
- [How it works](https://jvoltci.github.io/sparsh/docs/how-it-works.md): The handshake, the four channels, and the wire that carries a file.
- [Performance](https://jvoltci.github.io/sparsh/docs/performance.md): Every measured number, with the instrument that produced it.

## Reference

- [CLI](https://jvoltci.github.io/sparsh/docs/reference/cli.md): Every command the sparsh binary answers to, generated from its own usage text.
- [MCP tools](https://jvoltci.github.io/sparsh/docs/reference/mcp.md): The tools an agent sees, read from the running server rather than written down.

## Optional

- [The app itself](https://jvoltci.github.io/sparsh/): the browser client, which needs no install
- [Everything, one file](https://jvoltci.github.io/sparsh/docs/llms-full.txt): the whole documentation concatenated