Skip to content

NTU Omnibus: CLI reference

Service overview · CLI reference · MCP reference

Example

Check shuttle routes and arrival estimates.

ntu bus routes
ntu bus arrivals --route Blue --stop "North Spine" --source shuttle

Commands

Choose a command for its arguments, examples and result fields. Use ntu bus --help and append --help to a command for option details. Each command page identifies required arguments and any defaults. See the complete CLI reference for shared settings and all services.

Command What it does
ntu bus routes List public NTU shuttle routes and their published display colors.
ntu bus stops Search NTU shuttle and LTA bus stops by stop name or code, optionally limited to a route/service.
ntu bus arrivals Get arrival estimates for NTU shuttles and/or LTA services 179, 179A, and 199.
ntu bus live Get current live vehicle positions for one NTU campus shuttle route.
ntu bus status Get the published first/last bus schedule, public-holiday/special-day flags, and temporary notices for an NTU campus shuttle route.

Command details

ntu bus routes

List public NTU shuttle routes and their published display colors.

Usage

ntu bus routes

Use ntu bus routes --help for the current interface.

Arguments and options

  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: retrieved_at, source_urls, cached, routes, colors.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu bus stops

Search NTU shuttle and LTA bus stops by stop name or code, optionally limited to a route/service.

Terminal output combines matching records for the same stop and shows its routes. Distinct stop codes remain separate. Pagination still applies to the underlying stop-and-route records, so a stop can also appear on a later page. JSON output retains the original records and pagination fields.

Usage

ntu bus stops example

Use ntu bus stops --help for the current interface.

Arguments and options

  • QUERY: The search terms. Quote multiword text so the shell passes it as one argument.
  • --route: The published shuttle route or supported bus service. Choices: Blue, Brown, Green, Grey, Red, 179, 179A, 199.
  • --limit, -l: Maximum number of results to return in this page. Default: 20.
  • --offset: Number of results to skip before this page. Default: 0.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: retrieved_at, source_urls, cached, stops, total_count, next_offset.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu bus arrivals

Get arrival estimates for NTU shuttles and/or LTA services 179, 179A, and 199.

Usage

ntu bus arrivals --route Blue --stop "North Spine" --source shuttle

Use ntu bus arrivals --help for the current interface.

Arguments and options

  • --route: The published shuttle route or supported bus service. Choices: Blue, Brown, Green, Grey, Red, 179, 179A, 199.
  • --stop: A stop name or code.
  • --source: Which arrival-data source to use. Choices: all, shuttle, lta. Default: all.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: retrieved_at, source_urls, cached, route_filter, stop_query, shuttle_arrivals, lta_arrivals.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu bus live

Get current live vehicle positions for one NTU campus shuttle route.

Usage

ntu bus live

Use ntu bus live --help for the current interface.

Arguments and options

  • --route: The published shuttle route or supported bus service. Choices: Blue, Brown, Green, Grey, Red. Default: Blue.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: retrieved_at, source_urls, cached, route_code, reported_bus_count, source_timestamp, buses.

For the corresponding MCP operation and its field types, see the MCP schema.

ntu bus status

Get the published first/last bus schedule, public-holiday/special-day flags, and temporary notices for an NTU campus shuttle route.

Usage

ntu bus status

Use ntu bus status --help for the current interface.

Arguments and options

  • --route: The published shuttle route or supported bus service. Choices: Blue, Brown, Green, Grey, Red. Default: Blue.
  • --json, -j: Write the result as JSON to stdout; diagnostics go to stderr.

Result

The result may include: retrieved_at, source_urls, cached, route_code, schedules, schedule_from_local_db, is_public_holiday, is_special_day, special_day_notice, has_temporary_message, temporary_message, no_active_bus_message, no_operations_message.

For the corresponding MCP operation and its field types, see the MCP schema.