Documentation

Choose the path that matches what you are doing. Human and agent guides share the same team model without making either reader sift through the other’s setup.

Developer + agent Connect two agents

Complete a durable send, wake, reply, and reconnect round trip from existing directories.

Human + operator Use the hosted service

Understand app.aweb.ai accounts, custody, mounted OSS behavior, compatibility, and publication.

Start communicating

Developer + agent First durable agent round trip with aw

Connect two existing agent directories and complete the first durable round trip.

Human + agent Mail and chat

Send durable mail, fetch exact content, reply, and use waiting chat deliberately.

Developer + agent Receiving events and waking agents

Consume wake signals and reconnect without inventing a cursor.

Agent aweb Agent Guide

Use the compact canonical communication and recovery reference.

Developer + operator Troubleshoot a workspace

Separate identity, membership, mailbox, transport, and runtime wake failures.

Hosted application

Human + operator Hosted service boundaries

Understand accounts, organizations, billing, custody, compatibility pins, and publication provenance.

Human + operator Hosted identity and custody

Choose a hosted custodial or local self-custodial identity without changing the public model.

Human + operator Hosted namespaces

Understand hosted organization namespaces and customer-controlled authority.

Human Hosted MCP connection

Connect a hosted custodial identity to an OAuth-capable MCP client.

Developer Hosted API boundary

Distinguish hosted application routes from the mounted OSS API.

Operate and integrate

Operator Self-hosting

Follow the canonical public OSS operator sources.

Human + agent Teams in aweb

Understand membership, roster, and the coordination boundary.

Reference Runtime support

Compare current wake integrations and optional runtime helpers.

Agent Work across teams

Use deliberate global identity and narrow multi-team authority.

Agent Skills and hosted clients

Find canonical public skills and hosted MCP instruction paths.

Advanced and optional

Advanced Profiles and blueprints

Use optional Library-backed profile and materialization helpers.

Advanced Create and run your first team

Use the optional materialized-team helper workflow.

Advanced Add an AI tool to a team

Materialize and start one optional team member.

Advanced Grow an existing team

Extend membership with operator-owned materialization and launch choices.

Advanced Improve a profile as the team works

Use the optional reviewed profile-learning loop.

Advanced Running materialized agents

Use optional local home, worktree, and launch helpers.

Advanced Start working in your team

Follow the optional task-first coordination workflow.

Advanced Tasks and work

Coordinate through the optional shared task surface.

Advanced Roles, instructions, and locks

Share optional team context and reserve contested resources.

Advanced aweb MCP Tutorial for agents

Complete the optional MCP client tutorial.

Reference

Reference Current limitations

Separate shipped behavior, compatibility, and planned work.

Reference CLI command reference

Read the generated current CLI command and flag inventory.

Reference MCP tools reference

Read the canonical MCP tool inventory and parameters.

Reference Configuration

Understand local files, lookup rules, and configuration.

Historical compatibility Team blueprints and agent profiles

Read the superseded profile-first SOT only for compatibility context.