gotrain 🚂

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

No dependencies. No config. Just trains.

!CI
!Platform
!License

Why?

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

Install

Via npm (Recommended):
``bash
npm install -g gotrain-cli
`

One-liner (Universal Bash):
`bash
curl -sL https://raw.githubusercontent.com/gumadeiras/gotrain-cli/main/install.sh | bash
`

Usage

`bash


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
`

$3

`bash
$ 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 [--to ] | Show departures (optional destination filter) |
| arrivals [--from ] | Show arrivals (optional origin filter) |
| alerts [--station ] [--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 🐧