Add quick-contact-actions extension

- Fix icon and reorganize action panel sections
- Prepare for publishing: README, changelog, clean up tracked files
- Prepare for Raycast Store publishing
- Fix Open/Edit in Contacts to use AppleScript
- Add favorite contacts feature (⌘⇧S)
- Add Edit in Contacts action (⌘⇧O)
- Add detail pane profile picture and organization name
- Fix flicker: batch contacts and frequency into single render
- Fix selection: load frequency before showing cached contacts
- Revert detail pane to Metadata.Label with colored icons
- Revert list accessories to icons, add colored tags in detail pane
- Show primary label tags as accessories instead of count icons
- Group non-alpha contacts under # like standard phonebooks
- Group contacts by first letter in phonebook-style sections
- Fix frequently contacted: use Action with push() instead of Action.Push
- Add frequently contacted sorting with persistent tracking
- Add colored icons to ContactActions sections
- Revert Swift to original thumbnails, simplify detail panel to metadata-only
- Generate initials avatars for contacts without photos
- Use standard markdown image for circular contact photo in detail panel
- Circular contact photo in detail panel with name beside it
- Show circular contact photo in detail panel metadata
- Re-add contact photo to detail panel as small 80px image
- Remove oversized photo from detail panel, keep metadata only
- Fix detail panel image: encode spaces in file:// path
- Add detail side panel with contact info (⌘D toggle)
- Add empty search state and contact row accessories
- Add email addresses to FaceTime Video section
- Add Open in Contacts action (⌘O)
- Group copy actions into separate ActionPanel section
- Align shortcuts with Raycast built-in Contacts and add copy actions
- Fix reserved shortcut: ⌘P → ⌘⇧P for Call action
- Pre-compile Swift contact fetcher for faster startup
- Cache contacts for instant loading on repeat opens
- Add keyboard shortcuts for quick actions on main contact list
- Working state: contacts, photos, search ranking, contact argument feature

Author: ShixAJ

extensions/quick-contact-actions/.gitignore

@@ -0,0 +1,21 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+
+# Raycast specific files
+raycast-env.d.ts
+.raycast-swift-build
+.swiftpm
+compiled_raycast_swift
+compiled_raycast_rust
+
+# compiled Swift binary (rebuilt via prebuild)
+assets/get-contacts
+
+# misc
+.DS_Store
+
+# Claude Code
+.claude/
+CLAUDE.md

extensions/quick-contact-actions/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "printWidth": 120,
+  "singleQuote": false
+}

extensions/quick-contact-actions/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Quick Contact Actions Changelog
+
+## [Initial Version] - {PR_MERGE_DATE}
+
+- Search contacts with custom scoring (name, phone digits, email)
+- Quick actions: FaceTime Video/Audio, Phone, Message, Email
+- Detail side panel with profile picture and organization name
+- Circular photo (from Swift) or colored initials (SVG) in detail pane
+- Favorites section with pin/unpin support
+- Frequently contacted section (top 5)
+- Phonebook-style alphabetical sections
+- Open and edit contacts in Contacts.app via AppleScript
+- Contact argument for quick launch (auto-navigate on unique match)
+- Copy actions for name, phone, and email
+- Keyboard shortcuts for all actions

extensions/quick-contact-actions/README.md

@@ -0,0 +1,35 @@
+# Quick Contact Actions
+
+Search your macOS contacts and launch calls, messages, and emails instantly from Raycast.
+
+## Features
+
+- **Spotlight-style search** with smart scoring — matches by name, phone digits, or email
+- **Quick actions** — FaceTime Video/Audio, Phone Call, iMessage, Email
+- **Detail panel** (⌘D) with profile picture, name, and organization
+- **Favorites** (⌘⇧S) — pin contacts to the top
+- **Frequently contacted** — your top 5 most-used contacts appear automatically
+- **Open/Edit in Contacts** — jump straight to the contact in Contacts.app
+- **Contact argument** — type `qca ana` to auto-navigate if there's a unique match
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| ⌘⇧F | FaceTime Video |
+| ⌘⇧A | FaceTime Audio |
+| ⌘⇧C | Call |
+| ⌘M | Send Message |
+| ⌘E | Send Email |
+| ⌘O | Open in Contacts |
+| ⌘⇧O | Edit in Contacts |
+| ⌘D | Toggle Detail Panel |
+| ⌘⇧S | Toggle Favorite |
+| ⌘. | Copy Name |
+| ⌘⇧. | Copy Phone Number |
+| ⌘⇧E | Copy Email |
+
+## Permissions
+
+- **Contacts** — required to read your contacts. macOS will prompt automatically on first use.
+- **Accessibility** — required for "Edit in Contacts" (sends ⌘L keystroke to Contacts.app via System Events). macOS will prompt when first used.

extensions/quick-contact-actions/assets/extension-icon.png

@@ -0,0 +1,131 @@
+import Foundation
+import Contacts
+import CoreGraphics
+import ImageIO
+
+func makeCircularImage(from data: Data, size: Int) -> Data? {
+  let s = CGFloat(size)
+  guard let source = CGImageSourceCreateWithData(data as CFData, nil),
+        let cgImage = CGImageSourceCreateImageAtIndex(source, 0, nil),
+        let ctx = CGContext(data: nil, width: size, height: size, bitsPerComponent: 8,
+                            bytesPerRow: 0, space: CGColorSpaceCreateDeviceRGB(),
+                            bitmapInfo: CGImageAlphaInfo.premultipliedLast.rawValue) else { return nil }
+  let rect = CGRect(x: 0, y: 0, width: s, height: s)
+  ctx.addEllipse(in: rect)
+  ctx.clip()
+  ctx.draw(cgImage, in: rect)
+  guard let clipped = ctx.makeImage() else { return nil }
+  let outData = NSMutableData()
+  guard let destFinal = CGImageDestinationCreateWithData(outData, "public.png" as CFString, 1, nil) else { return nil }
+  CGImageDestinationAddImage(destFinal, clipped, nil)
+  guard CGImageDestinationFinalize(destFinal) else { return nil }
+  return outData as Data
+}
+
+// Handle open/edit mode — reveal contact in Contacts.app
+if CommandLine.arguments.count > 2 && (CommandLine.arguments[1] == "--open" || CommandLine.arguments[1] == "--edit") {
+  let isEdit = CommandLine.arguments[1] == "--edit"
+  let contactId = CommandLine.arguments[2]
+  let openStore = CNContactStore()
+  do {
+    let keys = [CNContactGivenNameKey as CNKeyDescriptor, CNContactFamilyNameKey as CNKeyDescriptor]
+    let contact = try openStore.unifiedContact(withIdentifier: contactId, keysToFetch: keys)
+    let name = "\(contact.givenName) \(contact.familyName)".trimmingCharacters(in: .whitespaces)
+    let escaped = name.replacingOccurrences(of: "\"", with: "\\\"")
+    var script = "tell application \"Contacts\"\nset thePeople to every person whose name is \"\(escaped)\"\nif (count of thePeople) > 0 then\nset selection to item 1 of thePeople\nend if\nactivate\nend tell"
+    if isEdit {
+      script += "\ndelay 0.1\ntell application \"System Events\" to keystroke \"l\" using command down"
+    }
+    let proc = Process()
+    proc.executableURL = URL(fileURLWithPath: "/usr/bin/osascript")
+    proc.arguments = ["-e", script]
+    try proc.run()
+    proc.waitUntilExit()
+  } catch {
+    fputs("error: \(error.localizedDescription)\n", stderr)
+    exit(1)
+  }
+  exit(0)
+}
+
+// Image cache dir passed as first argument (environment.supportPath from Raycast)
+let imageDir = CommandLine.arguments.count > 1 ? CommandLine.arguments[1] : NSTemporaryDirectory()
+let imageDirURL = URL(fileURLWithPath: imageDir, isDirectory: true)
+try? FileManager.default.createDirectory(at: imageDirURL, withIntermediateDirectories: true)
+
+let store = CNContactStore()
+let keysToFetch: [CNKeyDescriptor] = [
+  CNContactIdentifierKey as CNKeyDescriptor,
+  CNContactGivenNameKey as CNKeyDescriptor,
+  CNContactFamilyNameKey as CNKeyDescriptor,
+  CNContactOrganizationNameKey as CNKeyDescriptor,
+  CNContactPhoneNumbersKey as CNKeyDescriptor,
+  CNContactEmailAddressesKey as CNKeyDescriptor,
+  CNContactImageDataAvailableKey as CNKeyDescriptor,
+  CNContactThumbnailImageDataKey as CNKeyDescriptor,
+]
+
+let request = CNContactFetchRequest(keysToFetch: keysToFetch)
+request.sortOrder = .givenName
+var contacts: [[String: Any]] = []
+
+do {
+  try store.enumerateContacts(with: request) { contact, _ in
+    guard !contact.phoneNumbers.isEmpty || !contact.emailAddresses.isEmpty else { return }
+
+    let firstName = contact.givenName
+    let lastName = contact.familyName
+    let org = contact.organizationName
+    var name = "\(firstName) \(lastName)".trimmingCharacters(in: .whitespaces)
+    if name.isEmpty { name = org }
+    if name.isEmpty { return }
+
+    let phones = contact.phoneNumbers.map { labeled -> [String: String] in
+      let label = labeled.label.flatMap { CNLabeledValue<NSString>.localizedString(forLabel: $0) } ?? "Phone"
+      return ["label": label, "value": labeled.value.stringValue]
+    }
+
+    let emails = contact.emailAddresses.map { labeled -> [String: String] in
+      let label = labeled.label.flatMap { CNLabeledValue<NSString>.localizedString(forLabel: $0) } ?? "Email"
+      return ["label": label, "value": labeled.value as String]
+    }
+
+    var entry: [String: Any] = ["id": contact.identifier, "name": name, "phones": phones, "emails": emails]
+
+    // Include organization only when the contact has a real first/last name (org is supplementary)
+    if !firstName.isEmpty || !lastName.isEmpty, !org.isEmpty {
+      entry["organization"] = org
+    }
+
+    // Save thumbnail to disk and return the path
+    if contact.imageDataAvailable, let imageData = contact.thumbnailImageData {
+      let safeId = contact.identifier.replacingOccurrences(of: "/", with: "_").replacingOccurrences(of: ":", with: "_")
+      let imageURL = imageDirURL.appendingPathComponent("\(safeId).jpg")
+      if !FileManager.default.fileExists(atPath: imageURL.path) {
+        try? imageData.write(to: imageURL)
+      }
+      entry["imagePath"] = imageURL.path
+
+      // Circular crop for detail pane
+      let circleURL = imageDirURL.appendingPathComponent("\(safeId)_circle.png")
+      if !FileManager.default.fileExists(atPath: circleURL.path),
+         let circleData = makeCircularImage(from: imageData, size: 160) {
+        try? circleData.write(to: circleURL)
+      }
+      if FileManager.default.fileExists(atPath: circleURL.path) {
+        entry["circleImagePath"] = circleURL.path
+      }
+    }
+
+    contacts.append(entry)
+  }
+} catch {
+  fputs("error: \(error.localizedDescription)\n", stderr)
+  exit(1)
+}
+
+if let data = try? JSONSerialization.data(withJSONObject: contacts),
+  let json = String(data: data, encoding: .utf8)
+{
+  print(json)
+}

extensions/quick-contact-actions/assets/get-contacts.swift

@@ -0,0 +1,6 @@
+const { defineConfig } = require("eslint/config");
+const raycastConfig = require("@raycast/eslint-config");
+
+module.exports = defineConfig([
+  ...raycastConfig,
+]);