# Documentation Start with the [project README](../README.md) for installation and usage. ## Contribute to Albedo - [Repository instructions](../AGENTS.md): tools, tests, UI review, and contribution workflow. - [Change Albedo](../robot-docs/contributing.md): ownership, lifecycle, storage, and provider rules. - [Robot documentation](../robot-docs/README.md): subsystem behavior and links to its implementation. - [Write an extension](extensions.md): a worked Gleam example with tables, a Python binding, a command, a hook, moves, and cleanup, plus settings, host routes, and resource ownership. - [Extension API reference](extension-api.md): public SDK function documentation and the generated signature and type reference. ## Operate the daemon - [Daemon attachment and local startup](daemon-lifecycle.md): discovery, startup, restart, and login services. - [Manage Albedo with home-manager](home-manager.md): declarative installation and user services. ## Develop API clients - [OpenAPI contract](openapi.yaml): request, response, and stream shapes. - [HTTP API behavior](http-api-design.md): shared HTTP rules, settings, history, discovery, and runtime changes. - [Session lifecycle and recovery](http-sessions.md): creation, durable input, cancellation, shell commands, and side questions. - [HTTP streams and recovery](http-streams.md): session replay, reset, progress, collection invalidation, and overflow. - [Extension HTTP behavior](http-extensions.md): workspace scope, permissions, notifications, and one-time secrets. - [API architecture](http-api-architecture.md): state ownership and persistence boundaries. - [Change the HTTP API](contributing-api.md): contract ownership, implementation rules, and validation. - [Client API ownership](client-api.md): named operations, typed results, and transport recovery. ## Read the generated API reference Run `python3 scripts/api-reference.py` from the repository root, then open `docs/api-reference.html` in a browser. The [generator](../scripts/api-reference.py) embeds the current contract and pins the Scalar version. Viewing the page requires JavaScript and access to its CDN. The generated HTML is ignored by Git.