> Documentation index: https://dev.sprott.ai/llms.txt

# SafeClaw Docs

This documentation explains SafeClaw through concepts, task guides, security
pages, and reference pages. Contributor design docs live outside this tree in
[`design/`](https://github.com/getsafeclaw/safeclaw/tree/main/design).

New here? Read [Overview](https://dev.sprott.ai/docs/overview.md), then do the
[Quickstart](https://dev.sprott.ai/docs/quickstart.md).

## Concepts

| Page | The module |
|---|---|
| [Overview](https://dev.sprott.ai/docs/overview.md) | The whole model on one page: phantoms, the broker, passkey approvals |
| [Vault](https://dev.sprott.ai/docs/vault.md) | Where credentials live: sealed under your passkey, synced blind |
| [Connections](https://dev.sprott.ai/docs/connections.md) | The catalog, host anchors, and how a secret becomes a phantom |
| [Broker](https://dev.sprott.ai/docs/broker.md) | `sc run`: one local egress point that swaps phantoms for values |
| [Approvals & policy](https://dev.sprott.ai/docs/approvals.md) | Who decides what runs: levels, rules, single-use grants |
| [Agents](https://dev.sprott.ai/docs/agents.md) | Agent identities: attribution without possession |

## Guides

| Page | The task |
|---|---|
| [Quickstart](https://dev.sprott.ai/docs/quickstart.md) | Zero to first brokered call in five minutes |
| [`sc run` and phantoms](https://dev.sprott.ai/docs/sc-run.md) | The patterns, and the `sc get` anti-pattern |
| [For your agent](https://dev.sprott.ai/docs/for-your-agent.md) | Handing SafeClaw to an agent: skill file, paste-ready prompt |

## Security

| Page | The question |
|---|---|
| [Design principles](https://dev.sprott.ai/docs/design-principles.md) | The rules the whole system is built on |
| [Security model](https://dev.sprott.ai/docs/security-model.md) | Where keys live, what the cloud sees, what compromise costs |

## Reference

For users and service authors, in [`reference/`](https://dev.sprott.ai/docs/reference):
[services.md](https://dev.sprott.ai/docs/reference/services.md) (writing a `service.toml`),
[policy.md](https://dev.sprott.ai/docs/reference/policy.md) (per-action decisions),
[diagnostics.md](https://dev.sprott.ai/docs/reference/diagnostics.md) (every error code, with fixes),
[passkey-support.md](https://dev.sprott.ai/docs/reference/passkey-support.md) (which devices can encrypt a vault),
[platform-support.md](https://dev.sprott.ai/docs/reference/platform-support.md) (which OSes run the `sc` binary),
[consent-templates.md](https://dev.sprott.ai/docs/reference/consent-templates.md) (approval-copy grammar).

## Design docs

For contributors reading the source, outside this tree in
[`design/`](https://github.com/getsafeclaw/safeclaw/tree/main/design):
[protocol.md](https://github.com/getsafeclaw/safeclaw/blob/main/design/protocol.md) (SUDP cryptographic profile),
[credential-broker.md](https://github.com/getsafeclaw/safeclaw/blob/main/design/credential-broker.md) (the broker architecture),
[connection-schema.md](https://github.com/getsafeclaw/safeclaw/blob/main/design/connection-schema.md) (vault data shapes),
[sync.md](https://github.com/getsafeclaw/safeclaw/blob/main/design/sync.md) / [sse-sync.md](https://github.com/getsafeclaw/safeclaw/blob/main/design/sse-sync.md) (cloud sync),
[request-scope.md](https://github.com/getsafeclaw/safeclaw/blob/main/design/request-scope.md) (approval scope binding),
[stores-and-items.md](https://github.com/getsafeclaw/safeclaw/blob/main/design/stores-and-items.md) (stores and vault content model).
