translink-cli

name	translink-cli
description	Query, troubleshoot, and explain Translink SEQ GTFS static + realtime data using local translink_* commands or plugin slash commands. Use for schedule lookups, stop/route/trip joins, vehicle/trip realtime checks, alerts, schema drift review, PK/FK reasoning, and paginated filtering.

Translink CLI Skill

Use when working with Translink data in this environment.

Prerequisite

This skill requires the Translink CLI scripts to be installed and available in PATH.

• CLI repo: https://github.com/alanburchill/traslink-cli-scripts
• Expected commands: translink_* (or equivalent wrappers that expose the same command names)

If the CLI is not installed, stop and ask the user to install it first.

Command surfaces

• Shell CLI: translink_*
• Plugin slash commands: /translink_* and /translink <command> [args...]

Core workflow

1. Refresh or validate cache/schema with translink_schedule_refresh when freshness is uncertain.
2. Query with shared parameters (--where, --contains, --in, --page, --per-page, etc.).
3. On strict field errors, use fuzzy suggestions in the JSON error payload to auto-correct.
4. Use PK/FK references for joins across routes/trips/stops/stop_times/calendar/shapes.
5. For authoritative current schema, read generated schema docs first.

Shared parameter contract

All commands support:

• --where field=value (repeatable)
• --contains field=text (repeatable)
• --in field=v1,v2,... (repeatable)