Something went wrong. Try again.
small gleam coding and (not yet) persistent agent daemon with a detachable cli forked from okami.mom/albedo
Something went wrong. Try again.
Documentation #
Start with the project README for installation and usage.
Contribute to Albedo #
- Repository instructions: tools, tests, UI review, and contribution workflow.
- Change Albedo: ownership, lifecycle, storage, and provider rules.
- Robot documentation: subsystem behavior and links to its implementation.
- Write an extension: 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: public SDK function documentation and the generated signature and type reference.
Operate the daemon #
- Daemon attachment and local startup: discovery, startup, restart, and login services.
- Manage Albedo with home-manager: declarative installation and user services.
Develop API clients #
- OpenAPI contract: request, response, and stream shapes.
- HTTP API behavior: shared HTTP rules, settings, history, discovery, and runtime changes.
- Session lifecycle and recovery: creation, durable input, cancellation, shell commands, and side questions.
- HTTP streams and recovery: session replay, reset, progress, collection invalidation, and overflow.
- Extension HTTP behavior: workspace scope, permissions, notifications, and one-time secrets.
- API architecture: state ownership and persistence boundaries.
- Change the HTTP API: contract ownership, implementation rules, and validation.
- Client API ownership: 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 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.