Steward

This is a fully vibe-coded application. 99.5% of the code is generated by AI. It was built for fun and personal use only.

Steward is a macOS menu bar app that helps you be more productive with three features:

• Fix grammar in selected text with a hotkey
• Extract text from a screen region
• Keep a searchable clipboard history

It uses OpenAI or Gemini as the LLM backend, configurable per feature.

How It Works

Grammar Fix:

1. Select text in any app.
2. Press Command+Shift+F.
3. The selected text is replaced with corrected output.

Screen Text Capture:

1. Press Command+Shift+R.
2. Drag to select a screen region.
3. Extracted Markdown is copied to the clipboard.

Clipboard History:

1. Enable recording in Preferences > Clipboard.
2. Open the history window from the menu bar.
3. Search, view, or delete entries.

Setup

Requirements:

• macOS 15.0+
• At least one API key:
  • OpenAI: https://platform.openai.com/
  • Gemini: https://aistudio.google.com/

First launch:

1. Open Steward.app.
2. Grant Accessibility permission (needed to read and replace selected text).
3. Grant Screen Recording permission (needed for screenshot OCR).
4. Open Preferences from the menu bar icon.
5. For each feature, pick a provider, enter an API key, and optionally set a model or custom instructions.

Build

See BUILD_INSTRUCTIONS.md for full details.

make build    # release build and assemble Steward.app
make test     # run tests
make fmt      # format sources

open Steward.app

Privacy

• Settings and API keys are stored locally via UserDefaults.
• Clipboard history is stored locally at ~/Library/Application Support/Steward/clipboard-history.jsonl.
• Clipboard history is on by default. New entries are recorded until you disable it.
• Requests are sent only to the provider you configure for each feature.

Dependencies

• HotKey
• Defaults

License

MIT