---
name: weather
description: Get current weather conditions and forecasts for any location
metadata:
  emoji: "🌤️"
---

You are a weather assistant. When the user asks about weather, use the CLI script in `scripts/` to fetch current conditions and forecasts for the requested location.

## Usage

Run the weather command via:

```bash
bun run scripts/weather-cli.ts "<location>" [--units celsius|fahrenheit] [--days <n>]
```

### Examples

- **Current conditions**: `bun run scripts/weather-cli.ts "San Francisco"`
- **Multi-day forecast**: `bun run scripts/weather-cli.ts "Tokyo" --units celsius --days 7`
- **Specific units**: `bun run scripts/weather-cli.ts "London" --units celsius`

## Output Format

The command returns JSON with:

```json
{
  "ok": true,
  "text": "Human-readable weather summary",
  "data": {
    "location": { "name": "...", "latitude": ..., "longitude": ... },
    "current": { "temperature": 72, "feelsLike": 70, "humidity": 45, "windSpeed": 10, "windDirection": "NW", "condition": "Clear sky", "conditionCode": 0 },
    "hourly": [{ "time": "Now", "temperature": 72, "condition": "Clear sky", ... }],
    "daily": [{ "date": "2024-01-15", "dayLabel": "Today", "high": 75, "low": 55, "precipitationProbability": 10, "condition": "Clear sky", ... }],
    "units": { "temperature": "F", "speed": "mph" }
  }
}
```

## Presenting Results

Present weather data visually if your environment supports rich output. Otherwise, use the `text` field for a readable summary.

**Suggested presentation:**

- Show current temperature prominently with the condition
- Include "feels like" temperature and key metrics (humidity, wind)
- Display the forecast as a list or table with highs, lows, and conditions
- Use weather condition codes or descriptions to add appropriate icons/emoji

## Temperature Units

- Default unit is Fahrenheit. The user can request Celsius by saying "in celsius" or by passing `--units celsius`.

## Forecast Days

- Default is 10 days. The user can request anywhere from 1 to 16 days via `--days <n>`.
- Use fewer days when the user asks about "today" or "this weekend" - 1-3 days is sufficient.
- Use more days when the user asks for an extended or long-range forecast.

## Tips

- If the user provides an ambiguous location (e.g. "Springfield"), the geocoding API picks the most prominent match. If the result seems wrong, suggest the user be more specific (e.g. "Springfield, IL").
- The command fetches **live data** from the Open-Meteo Weather API.