Skip to content

CLI Calendar Directions

github-actions[bot] edited this page Aug 24, 2026 · 1 revision

ed calendar directions

Finds an event by exact ID, exact title or an unambiguous title fragment and opens its location in Apple Maps.

ed calendar directions <event> [--json]
ed calendar route <event> [--json]

The resolver searches the next 120 days. Completion offers live event IDs when the running app answers within its short completion deadline.

Plain output is one line:

$ ed calendar directions event-42
opening directions to 1 Infinite Loop

JSON has a stable object shape:

{
  "action": "directions",
  "id": "event-42",
  "location": "1 Infinite Loop",
  "opened": true,
  "title": "Studio visit",
  "url": "https://maps.apple.com/?q=1%20Infinite%20Loop&ll=37.3317,-122.0301"
}

Exit 3 means the event was not found or the title matched more than one event. Exit 4 means the app or calendar is unavailable, or the event has no location. The Maps URL includes the event coordinates when EventKit provides them and otherwise searches the location text.

For automation, list events first and pass the stable ID:

event_id=$(ed calendar ls --days 30 --json | jq -r '.[] | select(.location) | .id' | head -n 1)
ed calendar directions "$event_id" --json

CLI reference

Getting Started
Config
App
Extensions
Permissions
Usage
System
Music
Calendar
Clipboard
Color
Download
Apps
Tools
Shelf
Cleaner
Machines
Machines Remote
Machines Docker
Machines Files
Machines Power
Machines Workspace
Attention
Companion
Herdr
Lid Awake
Machines Terminal
Machines Thermal

Guides

Clone this wiki locally