---
name: railil
description: Search for Israel Rail train schedules using the railil CLI. Use when the user asks about Israeli trains, Israel Rail schedules, train routes in Israel, or mentions the railil tool. Find routes between stations with fuzzy search, filter by date/time, and output in various formats (JSON, Markdown, Table).
metadata:
  version: "0.1.0"
  homepage: "https://github.com/lirantal/railil"
  emoji: "🚆"
---

# Railil CLI

A CLI tool for checking Israel Rail train schedules.

## Installation

```bash
npm install -g railil
```

## Usage

The CLI supports fuzzy matching for station names.

### Basic Search

Search for the next trains between two stations:

```bash
railil --from "Tel Aviv" --to "Haifa"
```

### Date and Time

Search for a specific date and time:

```bash
railil --from "Beer Sheva" --to "Tel Aviv" --time 08:00 --date 2023-11-01
```

### Output Formats

For machine-readable output or specific formatting, use the `--output` flag.
Supported formats: `text` (default), `json`, `table`, `markdown`.

**JSON Output (Recommended for agents):**
```bash
railil --from "Tel Aviv" --to "Haifa" --output json
```

**Markdown Output:**
```bash
railil --from "Tel Aviv" --to "Haifa" --output markdown
```

### Options

- `-f, --from <station>`: Origin station name (fuzzy match supported).
- `-t, --to <station>`: Destination station name (fuzzy match supported).
- `-d, --date <date>`: Date of travel.
- `-h, --time <time>`: Time of travel (HH:MM).
- `-l, --limit <number>`: Limit the number of results.
- `-o, --output <format>`: Output format (`json`, `text`, `table`, `markdown`).
- `--help`: Show help message.

## Examples

**Find next 3 trains from Ben Gurion Airport to Jerusalem:**
```bash
railil --from "Ben Gurion" --to "Jerusalem" --limit 3
```

**Get schedule for tomorrow morning in JSON:**
```bash
railil --from "Haifa" --to "Tel Aviv" --time 07:30 --output json
```