GenGo is a native macOS app for processing selected text with Large Language Models. It lives in the menu bar, watches global shortcuts, and lets you translate, proofread, rewrite, or generate text without leaving the app you are working in.
GenGo is now developed and supported as a Swift / SwiftUI macOS application.
The older Electron implementation remains in electron/ for historical reference only. It is not the supported application, and new fixes or features should target the Swift app under swift/.
The project version is defined in one place: docs/version.json. The README badge, documentation site, and Swift release scripts read from that file.
- Menu bar app built with Swift and SwiftUI
- Global shortcuts for preset prompts and on-demand prompts
- Selected text capture and in-place replacement
- macOS accessibility integration for copy and paste workflows
- LM Studio: choose from models loaded in LM Studio
- Ollama: choose local or cloud models from the Ollama catalog
- Apple Intelligence: available on supported macOS versions
- OpenAI-compatible APIs: use a remote endpoint and API key when needed
- Preset prompts with custom shortcuts
- On-demand prompt mode
- Text generation mode when no text is selected
- Default preset for Japanese / English translation
- Up to 5 preset prompts
- Use LM Studio, Ollama, or Apple Intelligence for local-first workflows
- Use remote OpenAI-compatible providers only when explicitly configured
- Settings are stored locally in Application Support
Download the latest macOS release from:
https://github.com/TetsuakiBaba/GenGo/releases
On first launch, macOS may ask for confirmation because the app was downloaded from the internet. GenGo also needs Accessibility permission so it can read selected text and paste the processed result back into the active app.
Choose one provider:
Ollama
- Install Ollama.
- Create an account from https://ollama.com/.
- Sign in from the Ollama app Settings.
- Make sure Cloud is enabled if you want to use Ollama cloud models.
LM Studio
- Install LM Studio.
- Download a model from Discover or search.
- Load the model in LM Studio and start the local server.
Open GenGo from the menu bar and choose Settings.
- Select the LLM provider.
- Select a model from the available model list.
- Click the connection test button.
- Save after the connection succeeds.
- Select text in any macOS application.
- Press
Ctrl+1. - Japanese text is translated into English, and English text is translated into Japanese.
- Click Apply or press
Command+Enterto replace the selected text.
If you press a shortcut without selecting text, GenGo opens text generation mode.
| Shortcut | Action |
|---|---|
Ctrl+1 |
Default Japanese / English translation preset |
Ctrl+0 |
On-demand prompt / text generation |
Shortcuts can be changed in the Settings panel.
Requirements:
- macOS
- Xcode command line tools
- Swift Package Manager
Run the Swift app locally:
git clone https://github.com/TetsuakiBaba/GenGo.git
cd GenGo/swift
swift build
swift run GenGoSwiftSwift release packaging scripts live under swift/scripts/.
Create local release artifacts:
cd swift
chmod +x scripts/package-macos-app.sh scripts/release-macos.sh
SIGN_IDENTITY="Developer ID Application: YOUR NAME (TEAMID)" \
NOTARIZE_TARGET=none \
scripts/release-macos.shArtifacts are written to swift/dist/:
GenGo.appGenGo-<version>-macos-<arch>.zipGenGo-<version>-macos-<arch>.dmg- SHA-256 checksum text files
For notarized releases and GitHub Actions setup, see swift/README.md.
The repository also includes a GitHub Actions workflow at
.github/workflows/swift-release.yml.
It builds signed and notarized Swift macOS release packages on the macos-26
runner.
Required repository secrets:
MACOS_CERTIFICATE_P12_BASE64MACOS_CERTIFICATE_PASSWORDMACOS_KEYCHAIN_PASSWORDMACOS_SIGNING_IDENTITYAPPLE_IDAPPLE_TEAM_IDAPPLE_APP_SPECIFIC_PASSWORDSPARKLE_PUBLIC_ED_KEYSPARKLE_PRIVATE_KEY_BASE64
To test package creation without publishing a GitHub Release:
- Open Actions on GitHub.
- Select Swift macOS Release.
- Click Run workflow.
- Optionally enter a version. If omitted, the workflow uses
docs/version.json. - Download the generated workflow artifact after the run finishes.
The workflow artifact contains:
GenGo-<version>-macos-<arch>.zipGenGo-<version>-macos-<arch>.dmg- SHA-256 checksum text files
swift-appcast.xml
To create a draft GitHub Release with the same package files, push a Swift release tag:
VERSION="$(/usr/bin/plutil -extract version raw -o - docs/version.json)"
git tag "swift-v${VERSION}"
git push origin "swift-v${VERSION}"The tag must start with swift-v. After the workflow completes, review the
generated draft release on GitHub and publish it manually. Publishing a
swift-v* release also updates docs/swift/appcast.xml from the released
swift-appcast.xml.
GenGo/
├── swift/ # Supported Swift / SwiftUI macOS app
│ ├── Package.swift
│ ├── Sources/GenGoSwift/
│ └── scripts/
├── docs/ # Documentation website / GitHub Pages
├── icons/ # Shared application icons
├── electron/ # Legacy Electron implementation, unsupported
└── README.md
The Swift app stores settings in:
~/Library/Application Support/GenGo/settings.json
Older GenGoSwift settings are migrated when possible. Electron settings are separate and are not the supported configuration path.
- Website: https://tetsuakibaba.github.io/GenGo/
- Swift app notes: swift/README.md
- Releases: GitHub Releases
Contributions are welcome. Please target the Swift macOS app unless a change is explicitly about archived Electron code or documentation cleanup.
- Fork the repository.
- Create a feature branch.
- Make changes under
swift/,docs/, or shared assets as appropriate. - Run the relevant Swift build or documentation checks.
- Open a pull request.
If you encounter a problem:
- Open an issue: GitHub Issues
- Check the docs: GenGo Documentation
- View releases: GitHub Releases
Electron-specific issues are not currently supported.
This project is licensed under the MIT License. See LICENSE for details.
Tetsuaki Baba
- GitHub: @TetsuakiBaba
- Website: GenGo Documentation