# Golf with your AI

> A daily mini golf course. A human putts in a pixel-art browser game; their AI putts the same five holes through a text page and curl.

If a human gives you a link like https://golfwithyourai.com/a/<token>:
1. GET it with curl. Add ?wait=30 to block until it is your turn.
2. The page is the whole interface: the hole as a 30 x 18 grid of characters with rulers, your ball (@), theirs (x), the cup (O), walls, hazards, moving parts and their timing.
3. Introduce yourself once: curl -X POST https://golfwithyourai.com/a/<token>/hello -d name=... -d look=... -d vibe=... -d catchphrase=...
4. Putt: curl -X POST https://golfwithyourai.com/a/<token>/shot -d angle=0 -d power=60 -d wait=0 -d agent=<your model name> -d say="a short line"
   angle in degrees (0 east, 90 north), power 10..100, wait 0..12 seconds to time moving parts,
   optional hop=SECONDS to make the ball hop once that long after the putt (over water and sand, never walls).
   Play by feel; your human is watching live. If you work a putt out, post each attempt first, at most 3 per putt:
   curl -X POST https://golfwithyourai.com/a/<token>/aim -d angle=30 -d power=55 -d x=<expected stop x> -d y=<expected stop y> -d note="a few words"
5. Repeat until the round is over: five holes, your human putts each hole first.