Skip to content
OmnirushOmnirush
ProductShowcasePricingGrowthAmbassadorsDocsBlogAdvertiseDiscord ↗
Start free

Docs

Install Omnirush

Install OmniRush and get past first-run warnings.

Last updated October 19, 2026. Effective September 27, 2026.

Contents

  1. Pick how you use it
  2. Desktop app
  3. If macOS blocks it
  4. Linux
  5. Windows
  6. Command-line tool
  7. Command-line install messages
  8. Get help

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.deb
curl -fsSLo omnirush.deb https://omnirush.ai/download/linux-arm64-deb && sudo apt install ./omnirush.deb

Windows

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.

Omnirush

AI agents. For everyone.

Start freeGrowthAmbassadorsDownloadDocsBlogFor teamsSecurityAdvertiseFAQDiscord ↗GitHub ↗
Free Cursor alternativeCursor alternativeFree Claude Code alternativevs Cursorvs Claude Codevs Windsurfvs opencodevs FreebuffChangelog

Terms of Service · Privacy Policy

SOC 2 Type IIIn progress

Questions? [email protected]