Apple Maps (MacOS)

Setup

On first use, follow setup.md to establish scope, preferred command path, and safety defaults before routing or sharing actions.

When to Use

User wants to search places, categories, addresses, and routes in Apple Maps from macOS without browser-first workflows. Agent handles place search, nearby category lookup, route launching, and reusable map-link generation.

Requirements

• macOS with Maps.app installed.
• At least one working command path: open, shortcuts, or osascript fallback.
• Network access to Apple Maps for live place and route results.
• Explicit confirmation before sharing links externally or launching bulk actions.

Architecture

Memory lives in ~/apple-maps/. See memory-template.md for structure.

~/apple-maps/
├── memory.md             # Status, defaults, and validated command path
├── command-paths.md      # Command priority, probes, and URL strategy
├── safety-log.md         # Confirmations for high-impact actions
└── operation-log.md      # Search and route operation IDs with outcomes

Quick Reference

Data Storage

All skill files are stored in ~/apple-maps/. Before creating or changing local files, describe the planned write and ask for confirmation.

Core Rules

1. Use Apple Maps URL Workflows as Primary Interface

• Build map requests as explicit Apple Maps URLs and launch with open -a Maps.
• Prefer documented URL parameters instead of UI-only automation.

2. Probe Command Path Before Operations

• Verify command availability in strict order: open, shortcuts, osascript.
• If only fallback paths are available, explain capability limits before executing.

3. Keep Searches Bounded and Deterministic

• Require clear intent: query text, optional area, and optional map zoom/context.
• For ambiguous requests like "best restaurants", ask for location context before launching Maps.

4. Preview Generated URL Before Execution

• For every action, show the final URL and explain major parameters.
• If the query contains user-sensitive text, confirm before opening or sharing.

5. Confirm High-Impact Actions

• Require explicit confirmation for route launches with destination changes, share-link generation, and repeated bulk opens.
• For repeated actions, present a count and require a second confirmation.

6. Verify Result State After Launch

• After opening Maps, summarize expected visible outcome (query, destination, mode).
• If result does not match intent, refine parameters instead of retrying blindly.