Horus

AI-powered text correction for macOS – Fix spelling, grammar, and style with a single shortcut

✨ Features

• System-wide shortcut – Works in any macOS app
• One-click correction – Select text, press shortcut, done
• OpenAI powered – Uses GPT-4 for intelligent corrections
• Clipboard-based – Seamless text replacement
• Configurable – Custom shortcuts and API keys
• Native Swift – Fast and lightweight MenuBar app

🚀 Installation

Prerequisites

• macOS 13.0 or later
• OpenAI API key (Get one here)
• Xcode Command Line Tools: xcode-select --install

Build from source

# Clone the repository
git clone https://github.com/luisthieme/horus.git
cd horus

# Create config file
cp config.json.example config.json
# Edit config.json and add your OpenAI API key

# Build the app
./build.sh

# Copy config to app bundle
cp config.json Horus.app/Contents/Resources/

# Launch
open Horus.app

First run

1. Open Horus.app
2. macOS will ask for Accessibility permissions
3. Go to System Settings → Privacy & Security → Accessibility
4. Enable Horus

⌨️ Usage

1. Select any text in any application
2. Press Cmd+Shift+K (default shortcut)
3. Text is automatically corrected and replaced

⚙️ Configuration

Edit config.json:

{
  "openai_api_key": "sk-your-api-key-here",
  "shortcut": {
    "key": "k",
    "modifiers": ["command", "shift"]
  }
}

Available modifiers

• command (Cmd)
• shift (Shift)
• option (Option/Alt)
• control (Ctrl)

Available keys

Any letter (a-z) or number (0-9)

🎨 Custom Icons

See ICONS.md for instructions on creating custom app and menubar icons.

📝 License

MIT License - feel free to use and modify

🤝 Contributing

Contributions welcome! Open an issue or submit a pull request.

---

Note: This app requires your own OpenAI API key. Usage costs apply based on OpenAI's pricing.