cal-cli

# ical — CLI for macOS Calendar

A Go CLI that wraps macOS Calendar. Sub-millisecond reads via cgo + EventKit. Single binary, no dependencies at runtime.

## Installation

```bash
go install github.com/BRO3886/ical/cmd/ical@latest
```

Or build from source:

```bash
git clone <repo-url> && cd ical
make build    # produces bin/ical
```

## Quick Start

```bash
# List all calendars (shows sources, colors, types)
ical calendars

# Create a new calendar
ical calendars create "Projects" --source iCloud --color "#FF6961"

# Show today's agenda
ical today

# List events this week
ical list --from today --to "end of week"

# Add an event with natural language dates
ical add "Team standup" --start "tomorrow at 9am" --end "tomorrow at 9:30am" --calendar Work --alert 15m

# Show event details (row number from last listing)
ical show 2

# Delete an event (--force skips confirmation prompt, required in scripts/agents)
ical delete 2 --force

# Search for events
ical search "meeting" --from "30 days ago" --to "next month"

# Export events to ICS
ical export --format ics --from today --to "in 30 days" --output-file events.ics
```

## Command Reference

### Event CRUD

| Command      | Aliases         | Description             |
| ------------ | --------------- | ----------------------- |
| `ical add`    | `create`, `new` | Create an event         |
| `ical show`   | `get`, `info`   | Show full event details |
| `ical update` | `edit`          | Update event properties |
| `ical delete` | `rm`, `remove`  | Delete an event         |

### Event Views

| Command        | Aliases        | Description                    |
| -------------- | -------------- | ------------------------------ |
| `ical list`     | `ls`, `events` | List events in a date range    |
| `ical today`    | —              | Show today's events            |
| `ical upcoming` | `next`, `soon` | Show events in the next N days |

### Search & Export

| Command      | Aliases | Description                             |
|...