albedo docs

Web client

The web client is a canvas of chat windows on a desktop and one chat at a time on a phone. It talks to the same daemon and the same agents as the terminal client, so you can start something in one and pick it up in the other.

On this page: Open it, Use it from your other devices, and Find your way around.

The web client's canvas: chats, a review with notes tied to its lines, a terminal and an artifact.

Open it

albedo web

This starts the daemon if none is running, serves the client on 127.0.0.1:4317, opens your browser, and prints a link that signs the browser in. In a terminal it also draws a QR code for your phone.

The server keeps running after the command returns:

albedo web --stop         # stop serving
albedo web --foreground   # serve in this terminal until Ctrl-C
albedo web --no-open      # print the link without opening a browser
albedo web --port 0       # pick a free port

With the Nix package this works straight away. From a checkout, build the client once first:

npm --prefix web ci
npm --prefix web run build

Use it from your other devices

Anyone holding a sign-in link controls the daemon, so only open the client to your own devices.

albedo web --allow 192.168.1.0/24
albedo web --allow 10.0.0.0 --allow 100.64.0.0   # trailing zeros mean any: 10.0.0.0/8

If a link got somewhere it should not have, albedo web --new-link replaces it and signs every browser out.

Find your way around

The web client tiled: three windows side by side.

Previous install Next discord