Skip to content

A desktop coding agent with free access to frontier models.

TypeScript

docs: first-launch steps for unnotarized builds

Samrat Talukdar56cd6a4da69d
diff --git a/README.md b/README.md
index 73592819..4bcfa12c 100644
--- a/README.md
+++ b/README.md
@@ -14,11 +14,16 @@ Installers are published on the [latest release page](https://github.com/omnirus
| Platform | Supported builds | Download format |
| --- | --- | --- |
-| macOS | Apple Silicon and Intel | `.dmg` and `.zip` |
+| macOS | Apple Silicon | `.dmg` and `.zip` |
| Windows | x64 | `.exe` installer |
| Linux | x64 | `.AppImage` and `.tar.gz` |
-> Community builds may show the operating system's standard unknown-developer warning until platform signing is configured.
+Builds are not notarized or Windows-signed yet, so the first launch needs one confirmation:
+
+- **macOS 15 and later**: the first open shows "Apple could not verify OmniRush.ai.app is free of malware" with only a Done button. Click Done, open System Settings > Privacy & Security, scroll to Security and click **Open Anyway** next to OmniRush.ai.app, then Open. Alternatively, in Terminal: `xattr -dr com.apple.quarantine /Applications/OmniRush.ai.app`.
+- **macOS keychain**: when the app asks to use "omnirush.ai Safe Storage" in your keychain, enter your Mac login password and choose Always Allow. That item only holds the key that encrypts your own omnirush.ai sign-in on this Mac; it is asked again when the app binary changes.
+- **Windows**: on the SmartScreen dialog choose More info > Run anyway. If setup reports "Extract: error writing to file", the download is incomplete or blocked: download again, compare the hash with `SHA256SUMS.txt`, free disk space, and retry.
+- **Linux**: `chmod +x` the AppImage, or unpack the tar.gz.
## What it does