Docs
Install Omnirush
Install OmniRush and get past first-run warnings.
Last updated October 19, 2026. Effective September 27, 2026.
Pick how you use it
One account works everywhere. Every account can use GPT 6 Astra (the default), GPT 6.1 Sol and GPT 6 Sol.
- Desktop app: the full workspace for a project folder, on Windows (x64), macOS (Apple silicon) and Linux.
- Command-line tool: for working in a terminal, on Windows, macOS or Linux with Node.js 22.19 or newer.
New here? Sign up in the console first. You need a GitHub account that is at least 7 days old. Most sign-ups are approved right away, a few by our team, and you can start as soon as yours is.
Desktop app
- Open the latest release.
- Download the file for your computer: omnirush-win-x64-<version>.exe for Windows, omnirush-mac-arm64-<version>.dmg for a Mac with Apple silicon, or the .AppImage, .deb or .pacman file for Linux (x64 or arm64).
- Install it, open it, and sign in with your email.
The app updates itself. When a new version is ready it tells you, and it installs on the next restart.
To check a download, compare its SHA-256 with SHA256SUMS.txt on the same release page.
If macOS blocks it
"OmniRush can't be opened because Apple cannot check it for malicious software": try to open the app once and close the message. Then open System Settings, then Privacy & Security, scroll to Security, and click Open Anyway next to the OmniRush message. Confirm with your password or Touch ID. You only do this once per version.
"OmniRush is damaged and can't be opened": move the app to Applications, then run this once in Terminal: xattr -dr com.apple.quarantine /Applications/OmniRush.app
Signed and notarized builds are on the way. Once they ship, these steps won't be needed.
Linux
- AppImage: make it executable (chmod +x omnirush-linux-*.AppImage), then run it.
- Debian and Ubuntu: sudo apt install ./omnirush-linux-*.deb
- Arch: sudo pacman -U omnirush-linux-*.pacman
Or on Debian and Ubuntu, from a terminal (x64, then arm64):
curl -fsSLo omnirush.deb https://omnirush.ai/download/linux-deb && sudo apt install ./omnirush.debcurl -fsSLo omnirush.deb https://omnirush.ai/download/linux-arm64-deb && sudo apt install ./omnirush.debWindows
Run the installer (omnirush-win-x64-<version>.exe), then open OmniRush from the Start menu and sign in with your email.
If Windows SmartScreen says "Windows protected your PC", click More info, then Run anyway.
Command-line tool
- Install Node.js 22.19 or newer from nodejs.org. Check with node --version.
- Install OmniRush: npm i -g omnirush@latest
- Sign in with omnirush login, then run omnirush in a project folder.
Useful commands: omnirush --help, omnirush doctor (checks your setup), /subagents (the model sub-agents use) and /status.
Update any time with the same install command.
On Windows it runs natively in PowerShell or Command Prompt; WSL is optional. After installing, open a new terminal window: one that was already open does not see the new command and says 'omnirush' is not recognized.
Command-line install messages
npm warn deprecated … or allow-scripts warnings: notices from packages OmniRush uses, not errors. The install still works.
EACCES: permission denied (macOS or Linux): don't use sudo with npm. Install Node through a version manager such as nvm, or set a user-owned npm prefix (npm config set prefix ~/.npm-global, then add ~/.npm-global/bin to your PATH).
Your antivirus flags a file during install: restore it from the quarantine list and tell us in the Discord.
Get help
How tokens are counted, when your allowance resets and how to get a Good session: see the guide.
Ask in the Discord or email [email protected].
Using OmniRush means you agree to the Terms and Privacy Policy.

