Releases: MacPaw/project-echo
Releases · MacPaw/project-echo
v1.0.0 — first public release
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
NSWorkspacenotifications. - Accessibility-API text editing — Echo reads and updates
AXTextAreacontent 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_AIenv 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
- macOS 14.0+
- Xcode 15.0+
- An OpenAI API key (set as
OPEN_AIenv var)
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.