A command-line tool that connects your Ride with GPS account to Claude, giving you a conversational interface to your cycling data.

Log in, type ride, and start asking questions about your routes, rides, and segments in plain English.

Explore your ride history

• "What were my longest rides last summer?"
• "Show me all my rides in Oregon that had more than 3,000 feet of climbing"
• "How has my weekly mileage changed over the past year?"

Plan and analyze routes

• "Find me a gravel route near Bend under 50 miles"
• "What's the elevation profile like on this route?"
• "Compare these two routes and tell me which one is hillier"

Get training insights

• "What's my average distance per ride this month vs last month?"
• "Which of my rides had the best climbing-to-distance ratio?"
• "Summarize my riding stats for 2025"

Work with the RWGPS API directly

• Browse and search the full API docs from your terminal
• Make authenticated API calls without dealing with tokens
• Script bulk operations against your account

curl -fsSL https://raw.githubusercontent.com/ridewithgps/ride-cli/master/install.sh | bash

Installs a single binary to /usr/local/bin/ride. Works on macOS and Linux.

• Claude Code CLI (npm install -g @anthropic-ai/claude-code)

ride login    # authenticate with Ride with GPS (opens your browser)
ride status   # verify everything is connected
ride          # start a conversation

That's it. Once you're in a session, just ask questions or give instructions in natural language. Claude has access to your RWGPS data through a set of server-provided tools and can search rides, analyze routes, look up segments, and more.

ride                # start a conversation
ride --continue     # resume your last conversation
ride --model sonnet # use a specific model

Any flags not recognized by ride are passed directly to Claude Code, so all Claude CLI options work.

ride ask "what was my longest ride this year?"

Prints the answer and exits. Useful for scripting or quick lookups.

ride tool list
ride tool search_my_rides --limit 10 --query "gravel"
ride tool analyze_route '{"route_id": 12345, "include_wind": true}'

Run RWGPS tools directly without going through a Claude conversation. Handy for scripting or debugging.

Make authenticated calls to the RWGPS public API:

ride api get /api/v1/users/current
ride api get /api/v1/trips.json --query page_size=10 --query visibility=private
ride api post /api/v1/events.json --json @event.json
ride api delete /api/v1/routes/123.json

Options: --query key=value, --header "Name: value", --json <json|@file>, --data <text|@file>.

Browse the RWGPS API documentation without leaving your terminal:

ride api docs list                          # list all endpoints
ride api docs find "users current"          # search by keyword
ride api docs show get /api/v1/users/current # full details for one endpoint

Results are cached locally. Use --refresh to bypass the cache.

OAuth credentials are stored in ~/.config/ride/config.json with restricted permissions.

ride status

This shows your auth state, API connectivity, and whether Claude Code is installed. Common fixes:

• Not logged in -- ride login
• claude not found -- npm install -g @anthropic-ai/claude-code
• ride not found -- make sure /usr/local/bin is in your PATH

MIT