Open Antigravity
Your Chromebook and ~/tui-build workspace are ready. Open Antigravity to get started.
antigravity ~/tui-build
- Click Trust when asked. Antigravity picks up the nine skills from .agents/skills/.
- If it asks you to sign in: Business account › Continue with Google Cloud › pick your Gemini Enterprise seat (or Other › project
{{project}},global).
Use the Copy button on any box. Terminal commands go in the Chromebook Terminal; prompts go into the Antigravity chat. Lines starting with # aren't copied.
Build the concierge
Have Antigravity build it layer by layer, or run the finished reference app first.
~/tui-build already has the nine skills, the catalogue snapshot, and your .env. Paste this into Antigravity—it will build one layer at a time and pause after each smoke test until you reply go.
Build the TUI Holiday Concierge
Reply go after each layer. When it finishes, run make serve in ~/tui-build and open localhost:8080.
Fix a failing smoke test
Short on time? Build layers 1–5 yourself, then ask Antigravity to pull layers 6–7 from the reference. Layer 5 (planner + checker) is the heart of it.
{{repoDir}} has the complete working app—great for a quick preview or comparing against your build:
cd {{repoDir}}
make test # offline tests (~40 tests)
make serve # http://localhost:8080Open http://localhost:8080 and jump to Step 3. Press Ctrl+C to stop the server.
How one chat turn works
Quick overview (1 minute)
Try it like a traveller
With make serve running (your build or the reference), type these into the chat at localhost:8080.
1 · Discover
Expect destination photo cards with temperature, flight time and "Plan this trip".
2 · Plan
Watch "Behind the scenes" stream, the Colosseum draw itself into the header, and the plan appear with photos and a total.
3 · Change it in your own words
Expect a "Change applied" card and a yellow UPDATED stop. Only that part of the canvas is patched (A2UI updateDataModel).
4 · Constraint that matters
Then try the buttons
- Simulate event › Rain on day 2: the Trip Watcher changes only day 2, keeps the hotel and flights, and makes the 09:00–12:00 stops indoor.
- Undo restores the previous version. Map shows the stops on Google Maps. Governance shows the runtime, registry, data and A2UI wire.
- Switch the hotel in Your trip and watch the total change.
Curious what the canvas receives? Open Chrome DevTools › Network › stream and read the A2UI messages.
Extend it: pick a track
Pick one track for your team. Run make test after each change.
Indoor experiences near the hotel
A graph-powered tool the planner can call on rainy days.
A rule Gemini must respect
Add a Python check and watch the repair loop enforce it.
A new disruption
A local "museum closed" event, without touching BigQuery.
Budget meter
A new A2UI widget in TUI's style, patched live.
Walking routes on the map
Routes API v2 polylines between stops, key kept on the server.
Pitch your own
Anything that makes the concierge better for TUI travellers.
Indoor experiences within walking distance
At most two paid experiences per day
"Museum closed" disruption, local only
Budget meter on the plan
Walking routes between stops
Shape your own idea
Keep the basics intact: Gemini only picks IDs, Python checks the plan, shared data stays read-only, and API keys stay on the server.
Show it
Five minutes per team: a live demo and a quick deck on how it works.
A TUI-branded readout deck
# if the agent didn't start it for you
cd {{repoDir}}/.agents/skills/tui-deck-gen/examples && python3 -m http.server 8000Demo checklist
- Start from a clean chat, plan a trip, then change it once.
- Show your new feature live and run
make test. - Call out which skills helped and one thing you had to steer.
Optional extras
Brainstorm test scenarios
Open Gemini Enterprise and ask: "Give me five tricky traveller prompts to stress-test a live holiday concierge (weather, mobility, budget, closures)."
Deploy your own copy
Only if your facilitator enabled deploy rights. Use your own service name, never the shared tui-concierge-web:
cd {{repoDir}}
SVC="tui-$(gcloud config get account | cut -d@ -f1)"
gcloud run deploy "$SVC" --source . --region europe-west1 --project {{project}} \
--allow-unauthenticated --memory 2Gi --timeout 300 \
--env-vars-file <(grep -E '^[A-Z_]+=' .env | sed -E 's/^([A-Z_]+)=(.*)$/\1: "\2"/')Bonus: run an agent swarm
Got a few minutes left? Type /swarm in Antigravity to fan out parallel agents and QA your live app.
Make sure make serve is running on localhost:8080, then start a message with /swarm in Antigravity so multiple agents split the audit in parallel:
Fact-check and click-test every Maps location
Tip: you can aim /swarm at any big task—parallelising tests, reviewing UI states, or checking multiple destinations at once.
The nine skills
Antigravity loads them from .agents/skills/. Each one owns a layer of the app.
| Skill | What it teaches the agent |
|---|---|
tui-concierge-quickstart | Start here: build order, setup, acceptance checklist, one-step rebuild (materialize.py) |
tui-concierge-data-graph | Shared BigQuery catalogue + GQL on the property graph, offline snapshot |
tui-concierge-maps-grounding | Places API (New), Routes v2, server-side photo proxy, attribution rules |
tui-concierge-a2ui-v1-canvas | A2UI 1.0: createSurface once, then surgical updateDataModel patches |
tui-concierge-adk-replanner | Live planner: Gemini picks IDs, code checks the plan, repair loop, Trip Watcher rules, ADK agents |
tui-concierge-registry-deploy | FastAPI server, Cloud Run, Agent Engine and Agent Registry governance |
tui-concierge-brand-ui | The three-column front end: chat, streaming, photos, landmark banner, map |
tui-concierge-design-system | TUI tokens, type, layout, components and reference screens (no Figma or Stitch needed) |
tui-deck-gen | TUI-branded single-file HTML decks for your show-and-tell |
Query the live graph
Command cheat sheet
Everything runs from {{repoDir}} in the Terminal.
| Command | What it does |
|---|---|
make doctor | Readiness check (tools, sign-in, BigQuery, Gemini, Maps key) |
make test | Offline test suite (no BigQuery, stub model) |
make test-live | Live BigQuery + Gemini end-to-end test |
make serve | Run the concierge on http://localhost:8080 |
make snapshot | Refresh the offline copy of the shared catalogue (read-only) |
open http://localhost:8080/static/specimen.html | The living design system (tokens, type, components) |
cd {{repoDir}}
make test && make serveTroubleshooting
Most issues are one command away.
Antigravity keeps asking me to sign in, or says "keyring is locked"
export $(dbus-launch)
antigravity {{repoDir}}Antigravity says I have no licence or hit a quota
In the licence selector choose Other › project {{project}} › location global. If that fails too, tell your facilitator (they check your Gemini Enterprise seat and the agentspaceUser role).
"Not signed in", "Reauthentication is needed" or permission errors
gcloud auth login --update-adc
gcloud config set project {{project}}
gcloud auth application-default set-quota-project {{project}}The page at localhost:8080 doesn't load
Is make serve still running in a Terminal tab? Start it again. If Chrome still can't connect, try http://penguin.linux.test:8080.
No photos or no map (Maps key missing)
Your .env lacks the Maps key. Run this in the folder you serve from, then restart make serve:
sed -i "s|^GOOGLE_MAPS_API_KEY=.*|GOOGLE_MAPS_API_KEY=$(gcloud secrets versions access latest --secret={{mapsSecret}} --project={{project}})|" .envThe agent wants to write to BigQuery or change the shared data
Say no. Other teams use the same tables; use local files (like data/local_events.json) or the offline snapshot with USE_LIVE_BQ=false.
Tests fail after a change
Facilitator setup
Done before the session, per Chromebook. Participants skip this.
- Sign in to ChromeOS as the participant (alpha / beta / gamma), then Settings › About ChromeOS › Developers › Linux development environment › Set up (20 GB or more).
- In the Terminal, run the installer. It installs Antigravity, the Google Cloud CLI and uv, selects project
{{project}}(europe-west1), signs in once (covering both the CLI and application-default credentials), downloads the bundle and runs the readiness check.
curl -fsSL {{guideUrl}}/setup.sh | bash
cd {{repoDir}} && make doctorThen open Antigravity once and sign in: Business account › Continue with Google Cloud › licence. Intel/AMD Chromebooks only: Antigravity crashes on ARM64.
Rules of the road
Short, and they matter.
- Don't change the shared data. Your account could write to it, but all three teams use the same tables: put new data in local files or your own dataset. The catalogue is synthetic demo data built from real Google places; prices are indicative.
- No secrets in prompts or code. The Maps key lives in
.envand on the server only; never paste it into a chat or commit it. - Google Maps Platform terms: show the Google Maps attribution and photo author credits wherever a map or photo appears; use place data only inside this app; don't cache Places content beyond what the app already does.
- Real answers only. No canned replies or seeded plans; the model chooses catalogue IDs and the plan checker has the final word.
- Be kind to the shared project: one
make serveat a time, stop long loops, and tell your facilitator if something burns quota.