gotrain 🚂

Atomic CLI for MTA system train departures (NYC Subway, LIRR, Metro-North)

No dependencies. No config. Just trains.

Why?

Most train apps are bloated. This is one shell script.

Install

Via npm (Recommended):

npm install -g gotrain-cli

One-liner (Universal Bash):

curl -sL https://raw.githubusercontent.com/gumadeiras/gotrain-cli/main/install.sh | bash

Usage

# Search stations
gotrain stations penn       # Search for "penn"
gotrain stations            # List all stations

# Departures & Arrivals
gotrain departures MNR-149  # Departures from New Haven
gotrain departures nh --to MNR-1 # Filter departures to Grand Central (using alias)
gotrain arrivals MNR-1      # Arrivals at Grand Central
gotrain arrivals MNR-1 --from nh # Filter arrivals from New Haven

# Service alerts
gotrain alerts              # Active service alerts

# Favorites
gotrain favs add MNR-149 nh  # Add with alias 'nh'
gotrain favs rm nh           # Remove by alias
gotrain favs                 # List favorite stations

Examples

$ gotrain stations "new haven"
🟥 MNR │ New Haven (CT) Lines: New Haven ♿ ID: MNR-149
🟥 MNR │ New Haven-State St (CT) Lines: New Haven ♿ ID: MNR-150

$ gotrain departures MNR-149
Departures for New Haven (MNR-149)
──────────────────────────────────────────────────────────
10:39 AM EST │ Grand Central  (Off Peak) [Line: New Haven]
             │ On Time        Track 1 (Train #1539)

11:24 AM EST │ Grand Central  (Off Peak) [Line: New Haven]
             │ On Time        Track 2 (Train #1545)

$ gotrain favorite add MNR-149 home
Added MNR-149 to favorites (Alias: home) ✅

$ gotrain departures home
🟦 Departures for New Haven (MNR-149)
──────────────────────────────────────────────────────────
...

$ gotrain alerts
⚠️  Uptown [4][5] trains are running with delays...
   No description....

Commands

| Command | Description | |---------|-------------| | stations [query] | Search/list stations | | departures <id> [--to <id>] | Show departures (optional destination filter) | | arrivals <id> [--from <id>] | Show arrivals (optional origin filter) | | alerts [--station <id>] [--all] | Active service alerts (optional station filter, all alerts) | | favs [add|rm] [id] [alias] | Manage favorites (list, add, remove, toggle) |

Clawdbot Integration

This tool is available as a ClawdHub skill! Use it from any chat where Clawdbot is connected.

• Skill: gotrain on ClawdHub

Data Source

Powered by MetroFlow API — real-time MTA transit data.

Contributing

PRs are welcome! If you find any bugs or have feature requests, please open an issue.

• Development: Run ./tests/test_gotrain.py to verify changes locally.
• Style: Keep the script atomic. No external dependencies if possible.

License

MIT 🐧