A desktop application for managing Omni Code installations and sandboxes on Windows, macOS (Apple Silicon) and Linux.
The launcher handles installing the Omni Code runtime, managing Python environments, and launching Docker-based sandboxes with optional code-server and noVNC desktop access.
- One-click install of the Omni Code runtime (Python + venv managed automatically via
uv) - Sandbox management — launch Docker containers with workspace mounting, env file support, and configurable services
- Embedded webviews — access the Omni UI, code-server, and noVNC desktop directly in the launcher with tab/split layouts
- Dev console — built-in terminal with automatic venv activation
- Auto-updates — the launcher checks for updates on startup
- Docker must be installed and running on the host for sandbox functionality
- Node 22+ for development
Download the latest release from GitHub Releases.
- Open the launcher and click Install to set up the Omni Code runtime
- Select a workspace directory for your project
- Optionally select an env file and toggle code-server / desktop / Dockerfile.work
- Click Start Sandbox to launch
- Node 22+ and npm
- Rust (for building the
omni-sandboxbinary) — install via rustup:curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
- Docker (for sandbox functionality)
- bubblewrap (Linux only, for process sandboxing):
sudo apt-get install bubblewrap # Debian/Ubuntu sudo pacman -S bubblewrap # Arch
git clone https://github.com/ericmichael/omni-desktop.git
cd omni-desktop
npm i
npm run devnpm install automatically:
- Rebuilds native modules (
node-pty) - Downloads the
uvbinary for your platform - Builds
omni-sandboxfromsandbox-cli/(requires Rust)
If Rust is not installed, the sandbox build is skipped with a warning. Install Rust and run npm run build:sandbox to build it later.
On macOS, you may need to remove the quarantine flag from downloaded binaries:
xattr -d 'com.apple.quarantine' assets/bin/uvnpm run build # Build production bundles
npm run package # Package into installers (dist/)| Command | Description |
|---|---|
npm run dev |
Run in development with hot reload |
npm run build:sandbox |
Rebuild the sandbox binary |
npm run lint |
Run all checks (ESLint, Prettier, TypeScript, knip, dpdm) |
npm run fix |
Auto-fix lint + format |
npm test |
Run unit tests |
Local builds may require you to manually allow them to run on Windows and macOS.
On macOS, remove the quarantine flag if the app is rejected:
xattr -d 'com.apple.quarantine' /Applications/Omni\ Code.appApache-2.0