# Angelos Docs

This is the raw markdown index for the documentation routes.

## Get started

- [Connect Your Assistant](/docs/quickstart.md): Have your agent set up your own full-capability Angelos instance and connect an assistant with your passkey.
- [Meet Angelos](/docs/overview.md): Let an AI assistant help with your existing inbox, while you keep the mail apps you already use.
- [Changelog](/docs/changelog.md): Release-by-release changes to Angelos, with upgrade notes and links to the source.

## Use your inbox

- [Work with your inbox](/docs/inbox-guide.md): Find messages, catch up on conversations, inspect attachments, and organize mail with clear limits.
- [Write and send mail](/docs/sending-guide.md): Prepare a message, review exactly what will be sent, and handle the result without accidental duplicates.
- [Agent playbook](/docs/agent-guide.md): Use Angelos tools with exact message references, bounded searches, explicit review, and careful outcome handling.
- [Keep Angelos updated](/docs/keep-updated.md): Let your agent enable daily, checked release updates for your personal fork and existing Vercel instance.

## Reference

- [Gmail and Google Workspace](/docs/gmail-workspace.md): Configure one Gmail-enabled mailbox with server-side XOAUTH2 and conservative Gmail-specific safeguards.
- [Architecture](/docs/architecture.md): The Go MCP boundary, optional owner-only OAuth issuer, mail transports, and durable state.
- [Configuration reference](/docs/configuration.md): Configure one mailbox, TLS endpoints, OAuth access, and optional write features.
- [Safety and permissions](/docs/safety.md): Understand shared-mailbox effects, confirmation boundaries, send retries, and private-data handling.
- [OAuth reference](/docs/oauth-reference.md): Identity boundaries, token requirements, retention, revocation, and recovery for operators.
- [Tool reference](/docs/tools.md): The implemented MCP tools, input shapes, scopes, provider requirements, and limits.
- [Microsoft Graph reference](/docs/microsoft.md): Delegated Outlook.com and Microsoft 365 access, account-bound message identity, and Graph-specific limits.
- [Reply and forward details](/docs/natural-messages.md): Prepare ordinary client-style mail while preserving exact approval and privacy boundaries.
- [Client migration and token budget](/docs/tool-migration.md): Upgrade saved MCP calls safely and measure the complete discovery and response cost.

## Contributing

- [Run the tests](/docs/testing.md): Run Go and documentation checks without contacting a live mailbox.
- [Improve the docs](/docs/writing-docs.md): Run the docs site locally and add documentation alongside Angelos changes.