| name | places |
| description | Search nearby places, get details, and read reviews via the goplaces CLI and Google Places API. Use when user asks "find a restaurant near me", "what coffee shops are nearby", "get details for a place", or "show reviews".
|
| allowed-tools | ["Bash","Read","Write"] |
| model | haiku |
| user-invocable | true |
| when_to_use | When user wants to find nearby locations, get place details, or read reviews. Triggers: "find restaurants near", "coffee shops nearby", "what's open near me", "place details for", "reviews for", "search places".
|
| argument-hint | <action: search|details|reviews> <query> [location] |
Places
Search places and get details using goplaces CLI backed by the Google Places API.
Requires a GOOGLE_PLACES_API_KEY environment variable.
Prerequisites
brew install steipete/tap/goplaces
Set up your API key:
export GOOGLE_PLACES_API_KEY="AIza..."
Get a key: https://console.cloud.google.com → APIs & Services → Enable "Places API" →
Create Credentials → API Key.
Commands
| Command | Description |
|---|
goplaces search "<query>" --near "<location>" | Search places by type/name near a location |
goplaces search "<query>" --lat 25.0478 --lng 121.5319 | Search by coordinates |
goplaces details "<place_id>" | Get full details for a place (hours, phone, address) |
goplaces reviews "<place_id>" | List top reviews for a place |
goplaces search "<query>" --open-now | Filter to currently open places |
goplaces search "<query>" --radius 500 | Limit search radius in meters |
Usage Examples
Find coffee shops nearby:
goplaces search "coffee shop" --near "Taipei 101" --open-now
Get full details for a place:
goplaces details "ChIJN1t_tDeuEmsRUsoyG83frY4"
Read reviews:
goplaces reviews "ChIJN1t_tDeuEmsRUsoyG83frY4"
Search with coordinates:
goplaces search "ramen" --lat 25.0478 --lng 121.5319 --radius 1000
Rules
- Always check if CLI is installed first:
which goplaces
- If not installed, show the install command and stop
- Always check that
GOOGLE_PLACES_API_KEY is set: [[ -z "$GOOGLE_PLACES_API_KEY" ]] && echo "API key not set"
- Never print the API key value in output
- When listing results, show: name, rating, address, open status — limit to top 5 results by default
- For details, summarize: address, phone, hours, website, rating
- For reviews, show top 3 reviews (author, rating, snippet) — save full reviews to workspace/ if requested
- If location is ambiguous, ask the user to clarify before searching
