simulated-roadtrip

// Let your Clawbot go on a GPS-grounded road trip through the real world. Pick a route, choose a theme, and Turai generates narrated stops using real Google Maps data. Your agent posts updates as it "travels."

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

Simulated Road Trip

Let your Clawbot go on a GPS-grounded road trip through the real world. Pick a route, choose a theme, and Turai generates narrated stops using real Google Maps data. Your agent posts updates as it "travels."

Concept

Your agent picks a starting point and destination, and the Turai Road Trip API plans a real route with actual stops along the way. Each stop includes:

Real location data — GPS coordinates, place names, distances from Google Maps
Themed narration — Written from the perspective of someone actually traveling there
Atmosphere details — What you'd see, hear, smell, eat at each stop

The agent can drip-feed these stops over time — one per hour, one per day — creating an ongoing travel narrative in chat, on Moltbook, or any messaging channel.

Themes

Theme	Focus
`history`	Historical landmarks, battlefields, monuments
`foodie`	Local restaurants, street food, regional specialties
`haunted`	Ghost stories, abandoned places, local legends
`weird`	Roadside attractions, oddities, world's largest things
`nature`	National parks, scenic overlooks, wildlife
`art`	Galleries, murals, public art installations
`architecture`	Notable buildings, bridges, urban design
`music`	Venues, birthplaces of musicians, music history
`literary`	Bookstores, author homes, fictional settings
`film`	Filming locations, movie landmarks
`spiritual`	Temples, churches, sacred sites
`adventure`	Extreme sports, hiking, off-the-beaten-path

Setup

Get a Turai API key from turai.org
Set the environment variable:
```
export TURAI_API_KEY="your-key-here"
```

Usage

From the command line

# Basic road trip — NYC to LA, 5 stops, foodie theme
node skills/simulated-roadtrip/scripts/roadtrip.mjs \
  --from "New York City" \
  --to "Los Angeles" \
  --theme foodie \
  --stops 5

# Haunted road trip through New England
node skills/simulated-roadtrip/scripts/roadtrip.mjs \
  --from "Salem, MA" \
  --to "Sleepy Hollow, NY" \
  --theme haunted \
  --stops 4

# Drip-feed mode — post one stop every 2 hours
node skills/simulated-roadtrip/scripts/roadtrip.mjs \
  --from "Nashville, TN" \
  --to "New Orleans, LA" \
  --theme music \
  --stops 6 \
  --drip 2h

# Save trip data to JSON for later use
node skills/simulated-roadtrip/scripts/roadtrip.mjs \
  --from "Tokyo" \
  --to "Kyoto" \
  --theme art \
  --stops 4 \
  --output trip.json

Drip-feed intervals

1h, 2h, 4h — hours between posts
1d — one stop per day
30m — every 30 minutes (for impatient travelers)

From your agent

"Take a road trip from Chicago to Austin, music theme, 5 stops"

The agent should run the script, then post each stop as a chat message or social update.

API Reference

Endpoint: POST https://turai.org/api/agent/roadtrip

Headers:

x-api-key: Your Turai API key
Content-Type: application/json

Body:

{
  "from": "New York City",
  "to": "Los Angeles",
  "theme": "foodie",
  "stops": 5
}

Response: JSON with array of stops, each containing location data and narration.

Files

SKILL.md — This file
scripts/roadtrip.mjs — Main script