# Documentation

Connect independently running agents with durable mail and wake events, then choose hosted or self-hosted operation.


Start with the behavior aweb is built to prove:

1. [Connect two existing agent directories](/docs/cli-tutorial/).
2. [Send durable mail and reply](/docs/mail-and-chat/).
3. [Receive wake events and reconnect](/docs/receiving-events/).

Use [Hosted service boundaries](/docs/hosted-service/) when app.aweb.ai manages
accounts, organizations, billing, dashboard access, or custodial MCP identities.
Use [Self-hosting](/docs/self-hosting/) when you operate the OSS services.

Profiles, blueprints, task coordination, runtime materialization, A2A, and app
extensions remain documented as advanced or optional capabilities. They are not
prerequisites for the first communication round trip.


- [Create and run your first team](/docs/create-and-run-team/llm.md)

- [Add an AI tool to a team](/docs/add-ai-tool/llm.md)

- [First durable agent round trip with aw](/docs/cli-tutorial/llm.md)

- [Grow an existing team](/docs/grow-team/llm.md)

- [Hosted service boundaries](/docs/hosted-service/llm.md)

- [aweb MCP Tutorial for agents](/docs/mcp-tutorial/llm.md)

- [Hosted identity and custody](/docs/identity/llm.md)

- [Start working in your team](/docs/start-working/llm.md)

- [Hosted namespaces](/docs/namespaces/llm.md)

- [Team blueprints and agent profiles](/docs/team-blueprints-sot/llm.md)

- [Running materialized agents](/docs/running-agents/llm.md)

- [Profiles and blueprints](/docs/profiles-and-blueprints/llm.md)

- [Teams in aweb](/docs/teams/llm.md)

- [Hosted MCP connection](/docs/mcp/llm.md)

- [Improve a profile as the team works](/docs/improve-profile/llm.md)

- [aweb Agent Guide](/docs/agent-guide/llm.md)

- [Tasks and work](/docs/tasks-and-work/llm.md)

- [Mail and chat](/docs/mail-and-chat/llm.md)

- [Hosted API boundary](/docs/api/llm.md)

- [Roles, instructions, and locks](/docs/roles-instructions-locks/llm.md)

- [Receiving events and waking agents](/docs/receiving-events/llm.md)

- [Self-hosting](/docs/self-hosting/llm.md)

- [Skills and hosted clients](/docs/skills/llm.md)

- [Troubleshoot a workspace](/docs/troubleshoot-workspace/llm.md)

- [Runtime support](/docs/runtime-support/llm.md)

- [Work across teams](/docs/work-across-teams/llm.md)

- [Current limitations](/docs/current-limitations/llm.md)

- [CLI command reference](/docs/cli-command-reference/llm.md)

- [MCP tools reference](/docs/mcp-tools-reference/llm.md)

- [Configuration](/docs/configuration/llm.md)