Getting started

Get a full-stack preview of your change running in about five minutes. The happy path is: paste a PR, hit deploy, open the URLs, release when done.

Quick start (web console)

1. Open the web console: holo-server.abridge.coffee — sign in with your Abridge Google account (IAP).
2. Paste your GitHub PR URL.
3. Hit Deploy.
4. Open the Reservations tab to watch your PR deploy.

Holodeck auto-picks a free slot, resolves your PR's commit, fills in the rest of the environment from a baseline, and provisions it. When the slot is healthy, its page lists the per-service URLs you can open.

When you're done, release the reservation — that frees the slot and resets it to baseline.

Make sure your PR's images are built first. A commit's container images come from the repo's own CI (e.g. pr-<n>-<sha>). If a deploy fails early, it's usually because CI hasn't finished building your PR yet, or you pointed at a commit that was never built — wait for CI, then try again.

Drive it from your agent

Holodeck is built for agentic workflows — an agent (Cursor, a script, CI) can reserve, deploy, poll, and release without touching the UI.

The easiest path: clone the Holodeck repo and tell your agent to use the holodeck-api-client skill to deploy your PR. The skill already knows the reserve → deploy → poll → release recipe, so you don't have to spell out the API. Just make sure you're on VPN or Teleport so your agent can reach Holodeck.

Change the version in place

Pushed a new commit to your PR, or want to swap in a different branch/SHA? You don't need to tear down and re-reserve — change the version in place:

• In the UI: open your slot, find the service, click Change version, enter a new ref (branch, tag, or SHA), and confirm. Holodeck re-renders and re-deploys just that service — every other service keeps its current commit.
• Via your agent: ask it to change the version of a service in your slot; the skill uses the same replace operation under the hood.

This is the fast iteration loop: push a commit, wait for CI to build the image, then Change version to that commit — no new slot, no full re-provision.

Raw HTTP (when you need it)

owner is required. If ttl is omitted, the reservation defaults to 24 hours.

H=https://holo-api.abridge.coffee

# Reserve + provision (async → job_id)
curl -s $H/api/v1/reservations -X POST -H 'content-type: application/json' -d '{
  "owner": "myagent",
  "ttl": "4h",
  "source": {"type": "pr", "value": "https://github.com/abridgeai/<repo>/pull/<n>"}
}'

# Poll until completed | failed
curl -s $H/api/v1/jobs/<job_id>

# Inspect endpoints / sync / health
curl -s $H/api/v1/holodecks/<holodeck_id>

# Release when done
curl -s -X DELETE $H/api/v1/reservations/<reservation_id>

The live OpenAPI contract is always at $H/api/v1/openapi.yaml.