Fluent App

Fluent App is a native macOS menu bar app — and an Omarchy bar plugin — for AI-powered text shortcuts. Select text anywhere, trigger a global shortcut, and Fluent App rewrites, translates, summarizes, or transforms the text and pastes the result back.

What Changed

• Dedicated settings window instead of editing inside the menu bar popover.
• Shortcut management rebuilt around reusable templates and a persistent editor.
• Core logic moved into a testable FluentCore module.
• Build, release, signing, notarization, and coverage commands standardized.
• GitHub Actions prepared for CI, releases, and Apple-signed distribution.

Product Goals

• Fast global shortcuts for text workflows.
• Simple path to add more actions later.
• Public open source release quality, not a one-off personal utility.
• Clean release artifacts for GitHub and Apple distribution.

Current Shortcut Templates

macOS (menu bar app):

• Cmd+Shift+O: Translate
• Cmd+Shift+I: Improve Writing
• Cmd+Shift+G: Fix Grammar
• Cmd+Shift+S: Summarize
• Cmd+Shift+P: Make Professional

Omarchy: Ctrl+Alt+Shift + T/O/G/S/P (F opens the panel). Remappable.

Supported Providers

• OpenAI
• Anthropic
• Google Gemini
• xAI Grok

Local Commands

make build
make test
make coverage
make dmg
make release VERSION=1.2.0

Equivalent scripts:

./scripts/test_coverage.sh
VERSION=1.2.0 ./build_dmg.sh
./scripts/release.sh 1.2.0

Development Setup

Requirements:

• macOS 13 or newer
• Xcode Command Line Tools
• Optional for icon generation: brew install librsvg

Run locally:

swift run FluentApp

Installation Flow

1. Download the latest DMG from GitHub Releases. It is a universal build that runs on Apple silicon and Intel Macs.
2. Drag Fluent App.app to /Applications.
3. Launch Fluent App.
4. Grant Accessibility access in System Settings.
5. Add an API key for your preferred provider.
6. Configure or add shortcuts in the Settings window.

Release Flow

Local maintainer flow:

make coverage
VERSION=1.2.0 ./build_dmg.sh
./scripts/release.sh 1.2.0

build_dmg.sh builds a universal (arm64 + x86_64) binary and fails if a slice is missing. Set BUILD_ARCHS=arm64 for a faster single-architecture local build.

GitHub flow:

• release-please.yml manages changelog and version PRs.
• release.yml builds a DMG when a v* tag is pushed or when run manually.
• ci.yml validates the macOS app, the Omarchy plugin, and the website.
• sync-omarchy-plugin.yml publishes omarchy/ to fluent-omarchy on merge to main.

Apple Signing And Notarization

The repo is ready for signing and notarization, but you still need to provide the Apple credentials and certificates yourself.

Local environment variables:

export DEVELOPER_ID_APPLICATION="Developer ID Application: Your Name (TEAMID)"
export APPLE_ID="[email protected]"
export APPLE_APP_SPECIFIC_PASSWORD="app-specific-password"
export APPLE_TEAM_ID="TEAMID"
export NOTARIZE=1

GitHub secrets expected by release.yml:

• APPLE_DEVELOPER_ID_P12_BASE64
• APPLE_DEVELOPER_ID_P12_PASSWORD
• KEYCHAIN_PASSWORD
• DEVELOPER_ID_APPLICATION
• APPLE_ID
• APPLE_APP_SPECIFIC_PASSWORD
• APPLE_TEAM_ID

What you still need to do manually outside this repo:

• Create/export the Developer ID Application certificate as .p12.
• Generate an app-specific password for notarization.
• Confirm the final bundle identifier you want to ship.
• Validate the release on a clean Mac before public launch.

Architecture

The package is split intentionally:

• FluentCore: models, providers, settings logic, controller logic, testable contracts.
• FluentMacSupport: live macOS integrations for clipboard, hotkeys, launch at login.
• FluentApp: SwiftUI shell and settings UI.

This makes new shortcuts easy to add without touching the live platform adapters.

Privacy

• API keys stay local on the machine.
• Text goes directly from Fluent App to the provider you selected.
• No analytics, telemetry, or remote app backend is included.

Omarchy plugin

bash omarchy/tests/run.sh
omarchy plugin add https://github.com/alfonsobries/fluent-omarchy.git --enable
omarchy plugin update io.github.alfonsobries.fluent

Website

The landing site lives in expo/.

cd expo
npm ci
npm run build

License

MIT. See LICENSE.