---
epic: 7
story: 7.9
title: "Alfred / Raycast Extension"
status: draft
---

## Epic 7 — macOS App (Swift/SwiftUI)
**Goal:** A beautiful, native macOS app that feels like it belongs on the platform.

### Story 7.9: Alfred / Raycast Extension

As a **macOS power user**,
I want an Alfred or Raycast extension that evaluates CalcPad expressions inline,
So that I can perform quick calculations from my launcher without opening the full app.

**Acceptance Criteria:**

**Given** the user has installed the CalcPad Alfred/Raycast extension
**When** the user types `= 1920 / 3` or `calc 1920 / 3` in the launcher
**Then** the CalcPad CLI (`calcpad-cli`) is invoked and the result `640` is displayed inline

**Given** the extension shows a result
**When** the user presses Enter
**Then** the result is copied to the clipboard

**Given** the user types an expression with units, e.g., `= 5 km to miles`
**When** the extension evaluates it
**Then** the result `3.10686 miles` is displayed inline

**Given** the `calcpad-cli` binary is not installed or not found in PATH
**When** the extension attempts to invoke it
**Then** a helpful error message is displayed directing the user to install the CLI

**Given** the user types an invalid expression
**When** the extension evaluates it
**Then** an error message is displayed inline (not a crash)
