# Robot documentation Implementation references for models and engineers working on Albedo. The pages link related topics and the code that owns each contract. [Change Albedo](contributing.md) collects the project rules for ownership, runtime helpers, lifecycle, storage, providers, and testing. Topic pages add guidance specific to their interfaces. For documentation changes, follow the [wiki authoring instructions](AGENTS.md) and the [repository agent instructions](../AGENTS.md). ## API and operator guides - [HTTP API behavior](../docs/http-api-design.md): shared rules and links to session, stream, and extension contracts. - [OpenAPI](../docs/openapi.yaml): exact routes, variants, fields, and bounds. - [Change the HTTP API](../docs/contributing-api.md): contribution rules and validation. - [Daemon lifecycle](../docs/daemon-lifecycle.md): attachment, local startup, and native services. - [Home-manager](../docs/home-manager.md): declarative settings and service ownership. - [Documentation index](../docs/readme.md): API, client, and operator guides. ## Runtime and sessions - [Runtime](runtime.md): startup, preparation, tool calls, and kernel ownership. - [Sessions](sessions.md): input, live output, cancellation, and history. - [Operations](operations.md): durable admission, receipts, and recovery. - [Inbox](inbox.md): every input a session will read, in order, and the queue. - [Agents](agent-sessions.md): child sessions, mail, and verification. - [Workspaces](workspaces.md): locations, linked workspaces, and session moves. - [Worktrees](worktrees.md): checkout providers and session attachments. - [Settings](settings.md): configuration, preferences, and persistence. ## Kernel and tools - [Kernel](kernel.md): Python execution, jobs, and kernel lifecycle. - [Kernel state](kernel-state.md): saved variables and restoration. - [Context](context.md): request inspection and accounting. - [Compaction](compaction.md): projections, strategies, and retained history. - [Files](files.md): reading, editing, and searching files. - [Artifacts](artifacts.md): versioned content, previews, and client communication. - [Image generation](imagegen.md): drivers, references, output, and recovery. - [Command shims](shims.md): Nix and Cargo wrappers on job `PATH`. - [Direnv](direnv.md): workspace environment updates. ## Extensions and commands - [Extensions](extensions.md): the harness base, installation, selection, and composition. - [Write an extension](../docs/extensions.md): the checklist extension as a worked example of tables, a Python binding, a command, a hook, a transfer adapter, cleanup, registration, and daemon scenarios. - [Extension API reference](../docs/extension-api.md): function documentation, signatures, types, and SDK navigation. - [Plugins](plugins.md): extension contribution contracts. - [Commands](commands.md): command catalogs, invocation, and clients. - [Hooks](hooks.md): model and Python call hooks, verdicts, and command helpers. - [Skills](skills.md): discovery, activation, and resource reads. - [MCP](mcp.md): configured servers, editor servers, and Python calls. - [Web search](web-search.md): search bindings and provider selection. - [Paperclips](paperclips.md): model reports and user review. ## Providers and usage - [Authentication](auth.md): provider credentials and sign-in. - [Models](models.md): catalogs, model selection, and limits. - [Provider requests](provider-requests.md): transport, recorded attempts, and usage. - [Outbound proxies](network.md): direct or proxied outbound routes per service. - [Proxy](proxy.md): the OpenAI-compatible endpoint and request translation. - [Quota](quota.md): account readings and polling. - [Usage feed](usage-feed.md): the usage-core driver and consumers. - [Cache TTL](cache-ttl.md): policy data, precedence, and refresh. - [Cache warming](cache-warming.md): background requests and stop conditions. ## Clients and integrations - [TUI](tui.md): terminal client state, views, and rendering. - [Change a terminal screen](tui-contributing.md): shared components, keys, confirmations, and asynchronous requests. - [Web client](web.md): browser state and the local web server. - [ACP](acp.md): editor attachment, prompts, output, and MCP overlays. - [Webhooks](webhooks.md): signed intake and session delivery. - [Discord](discord.md): bot configuration, messages, and delivery. - [Computer use](cua.md): the CUA binding and driver lifecycle. - [Colab](colab.md): runtime management and remote connections. ## Development and release - [Testing](testing.md): concurrency, fixtures, and cleanup. - [Gleam checks](gleam-lint.md): lint rules and review profiles. - [Workspace packages](workspace-packages.md): reusable Gleam packages under `packages/`, their dependency direction, and how to add one. - [Migrations](migrations.md): storage changes, startup order, and the downgrade refusal. - [Performance](perf.md): measurement commands, metrics, and gates. - [Release](release.md): builds, packages, and smoke tests.