OkamiUNI combines a unified inbox, calendar and daily planning dashboard in a native SwiftUI/AppKit application. Accounts and mail are stored locally, queued actions survive going offline, and AI features use the provider you choose. The interface follows the original design and theme tokens, including 26 themes.
Latest: v0.5.4 — Four languages and bilingual documentation. See the changelog and documentation index. This release provides source code; it does not include a downloadable installer.
| Area | Current behavior |
|---|---|
| Daily dashboard | Today's plan on a scrolling timeline, people waiting for a reply, appointments, money and deadlines, account filtering and an anchored activity bar. |
| Unified inbox, provider folders, search, conversation stacks, swipe actions with Undo, keyboard shortcuts and custom context menus. | |
| Reader | Sanitized HTML, readable text, collapsible quoted history/signatures, attachments on demand and confirmation showing the real destination before opening a link. Remote images are blocked until allowed. |
| Sending | Gmail API or SMTP with TLS, account aliases from Gmail/Workspace, rich text, attachments, drafts and an offline queue with retry/error states. |
| Accounts | Google OAuth and IMAP/SMTP for providers accepting the implemented password authentication. Credentials live in Keychain; local data uses SQLite/GRDB. There is no hardcoded account limit. |
| Sync | IMAP IDLE, incremental Gmail history and network recovery; account reconnection preserves local account identity and data. |
| Calendar | Read/write access to macOS calendars through EventKit, including calendars configured in macOS; invitations and RSVP through the outgoing queue. |
| AI | Summaries, triage, suggested replies, writing tools and an assistant drawer (⌘J) or separate window. On-device Foundation Models and configured remote/CLI providers are supported. |
| Appearance | 26 themes, bundled fonts, resizable panes and native window controls. |
Connecting a remote or CLI AI provider intentionally enables automatic analysis and prepared replies through that provider. The AI settings switch restricts automatic work to this Mac. The interface identifies the destination; generated writing appears as a preview for acceptance. The interface language and AI response language are separate preferences.
The interface supports Português (Brasil), English, Deutsch and Français. Portuguese remains the default. In Settings → General → App language, choose a language or follow the system language. Quit and reopen the app to apply it to every window. If none of the system's preferred languages is supported, Portuguese is used.
Dates and numbers follow the selected interface language. Messages, provider folder names and other account content keep their original language. AI response preferences also include French. Account help is bundled for offline use in Portuguese and English; the English guides are used for English, German and French interfaces.
All maintained Markdown documentation is available in English and Portuguese. The documentation index links each pair. Historical plans retain their dates and original code examples; screenshots and design prototypes may contain Portuguese sample content.
Requirements: macOS 26, Xcode 26.6 / Swift 6.3 (the validated toolchain) and XcodeGen. On-device AI additionally depends on Foundation Models availability on the Mac.
git clone https://github.com/OkamiOps/okamiuni.git
cd okamiuni
# Create the local configuration only if it does not already exist.
test -e Config/Google.xcconfig || cp Config/Google.example.xcconfig Config/Google.xcconfig
xcodegen generate
xcodebuild -project OkamiUNI.xcodeproj -scheme OkamiUNI \
-configuration Debug -derivedDataPath build/DerivedData build
open build/DerivedData/Build/Products/Debug/OkamiUNI.appThe project specifies the maintainer's development signing team. For your own build, select your team and Apple Development certificate in Xcode, or supply your own DEVELOPMENT_TEAM to xcodebuild. Stable signing matters for Keychain access across builds. The generated .xcodeproj is not committed; persistent project changes belong in project.yml.
For Google accounts, configure the desktop OAuth client ID and, when supplied by Google, its client secret in the ignored Config/Google.xcconfig. Follow the Google OAuth guide. An empty configuration is valid: Google setup explains what is missing and the IMAP form remains available. See app passwords and provider compatibility before connecting an IMAP account.
For maintainers, Tools/rodar.sh rebuilds and opens the app. It also terminates the previous instance and clears saved window state, so use it deliberately.
Four Swift packages keep domain logic separate from views:
| Package | Responsibility |
|---|---|
UNICore |
Models, pure logic, mail/conversation/calendar behavior and localization. |
UNIDesign |
Theme tokens, typography and bundled fonts. |
UNIShell |
SwiftUI/AppKit screens, windows, controls and integration. |
UNISync |
Accounts, Google OAuth/API, IMAP/SMTP, Keychain, database and outgoing queue. |
App → UNIShell → UNIDesign
→ UNICore ← UNISync → Keychain · GRDB · Gmail API · IMAP · SMTP
Strict Swift concurrency checking is enabled. Civil calendar dates and minutes of the day are modeled explicitly; timestamps are converted at boundaries. The engineering decision record documents the reasons and historical validation evidence.
Tests use Swift Testing. Network tests use local servers or transport stubs; render tests host real SwiftUI/AppKit views offscreen without driving the user's keyboard or mouse.
python3 Tools/audit_localizations.py
swift test --package-path Packages/UNICore
swift test --package-path Packages/UNIDesign
swift test --package-path Packages/UNISync
swift test --package-path Packages/UNIShellFor focused localization verification and captures:
swift test --package-path Packages/UNICore --filter 'L10nTests|BundledTranslationTests'
UNI_RENDER_DIR=/tmp/okamiuni-localization \
swift test --package-path Packages/UNIShell --filter LocalizationRenderTests
swift test --package-path Packages/UNIShell --filter AccountsDocsTestsTranslations live in Packages/UNICore/Sources/UNICore/Resources/*/Localizable.strings. New interface strings use L10n.tr("Texto \(valor)"); catalog interpolation uses {0}, {1}, and so on. Keep all four catalogs aligned. Do not translate persisted identifiers, protocol values, account content or internal prompt identifiers. Update both documentation languages when behavior changes, and preserve historical source examples in plans.
The localization audit checks coverage, catalog parity and interpolation placeholders. Release-specific validation is recorded in the v0.5.4 notes; historical test totals are not a claim about a fresh full-suite run.
The native shell, account persistence, continuous sync, sending, EventKit calendar integration, AI assistant and daily planning dashboard are implemented. Version 0.5.4 adds four interface languages and bilingual documentation.
Upcoming work includes receivables and follow-ups derived from sent messages. Existing gaps include recurring-event workflows, direct CalDAV setup inside the app, fully indented provider-folder trees and forwarding an invitation with its .ics. CalDAV calendars already configured in macOS remain available through EventKit. Microsoft OAuth is not implemented; an app password does not make an OAuth-only provider compatible with the current IMAP route.
A visible control must perform its action or explain why it is unavailable. Changes to interactions should be verified through the real view/event path, and visual changes should be checked against design/tokens.json and the current daily dashboard reference.