Skip to content

Releases: MacPaw/project-echo

v1.0.0 — first public release

01 May 16:45
dc91943

Choose a tag to compare

First tagged release of Echo — a macOS prototype that pairs the macOS Accessibility API with OpenAI GPT-4o to act as an in-context AI assistant for the frontmost app.

Highlights

  • Real-time frontmost-application detection via NSWorkspace notifications.
  • Accessibility-API text editing — Echo reads and updates AXTextArea content in any focused macOS app.
  • Chat UI built with SwiftUI, embedded in AppKit through NSHostingController.
  • OpenAI GPT-4o integration powered by MacPaw/OpenAI Swift SDK.
  • Xcode 15 / macOS 14+ support.

Repository hardening (post-prototype cleanup)

  • Graceful handling of a missing OPEN_AI env var (no more cryptic nil-unwrap crashes); errors now surface as user-visible chat messages.
  • Removed debug print() calls from production paths.
  • Build CI workflow added (compiles on every PR/push to develop).
  • CodeQL workflow no longer pinned to a specific Xcode version.
  • SwiftLint configuration.
  • CONTRIBUTING.md, CODE_OF_CONDUCT.md, CHANGELOG.md, issue/PR templates, CODEOWNERS.
  • README rewrite: real clone URL, full Xcode-scheme env-var walkthrough, troubleshooting section.

Requirements

See the README for setup instructions and the CHANGELOG for full details.

Warning

Echo is an experimental prototype that demonstrates an approach. Use at your own risk.