Skip to Content
Keko

Previews

Every dev server a thread starts on Keko Cloud or your server gets a readable link of its own

When a thread on Keko Cloud starts a server that listens on a port, the server gets an address of its own, such as https://quick-scout-4821.supercolony.run. The name is given when the port first opens and stays the same for the machine's life, so links keep working while the thread does.

Threads on your server get previews the same way once it's set up with keko setup --previews. A preview there reaches only a server started in one of its threads' worktrees or projects, never anything else running on the machine, and Keko reaches it through the machine's own outbound connection, so no port is opened. A thread on This Mac runs its dev server on your Mac, where you open it on localhost as usual.

Open a preview

The thread's header shows its previews: the port, or how many there are. The panel has, for each one:

  • Open preview: in the work pane's browser.
  • Open in tab: in a tab of its own in the app.
  • Open in browser: in your default browser.
  • Copy share link, and the share links you've made, with Revoke.

Opening a preview whose Keko Cloud machine is stopped starts the machine. The page says it's starting and reloads until the server answers. A preview on your server answers while the server is online.

Who can open it

A preview opens for the thread's owner. A browser that isn't signed in is sent through Keko's sign-in with GitHub first, then back to the page.

A share link lets someone else open it without an account. Each link works once, for whoever opens it first, and expires after an hour unless it's used. Revoking it ends the link and the access it gave.

When a thread is archived or its machine is removed, its previews answer "This preview has ended". Unarchiving the thread brings them back. A server's previews end with their thread, and when the server is removed from your account.

Why a separate domain

Previews run whatever code the thread wrote, so they live on supercolony.run, a domain apart from keko.run. A preview page can't read or use your Keko sign-in.

On this page