Oxagen app
Download the Oxagen app, open it the first time on macOS, Windows, or Linux, and find the oxagen and tacho commands it puts on your PATH.
The Oxagen app puts one machine under Oxagen control. It bundles the oxagen and tacho commands, and enrollment runs through them.
Download
The newest Oxagen app for each platform
Every version, with SHA-256 checksumsmacOS 12 or newer. Open the .dmg and drag Oxagen to Applications. Builds are not yet notarized, so macOS refuses the first launch. Choose Done, then click Open Anyway in System Settings > Privacy & Security.
- Apple silicon (.dmg)Oxagen_aarch64.dmg
- Intel (.dmg)Oxagen_x64.dmg
Windows 10 or newer, x64.
- Installer (.exe)Oxagen_x64-setup.exe
- Installer (.msi)Oxagen_x64_en-US.msi
x86_64. Install the package for your distribution.
- .deb (Debian, Ubuntu)Oxagen_amd64.deb
- .rpm (Fedora, RHEL)Oxagen.x86_64.rpm
- AppImage (any distribution)Oxagen_amd64.AppImage
On first launch the app links the oxagen and tacho commands onto your PATH, so a new terminal can run them.
Every version, with a SHA-256 for each file, is listed at downloads.oxagen.sh. To check a download, put that version's SHA256SUMS.txt beside the file and run:
shasum -a 256 -c SHA256SUMS.txtFirst launch on macOS
Builds are not yet notarized, so macOS refuses the first launch and offers Move to Trash. Choose Done or Cancel instead.
- Open System Settings > Privacy & Security. On macOS 12 it is System Preferences > Security & Privacy.
- Scroll to the message about Oxagen and click Open Anyway.
- Confirm with Open and your login password.
The Open Anyway button shows for about an hour after the refused launch. macOS 15 removed the older Control-click and Open route, so that route no longer works.
If you already have a terminal open, clearing the quarantine flag does the same thing:
xattr -dr com.apple.quarantine /Applications/Oxagen.appThen open Oxagen as usual. Either way, macOS asks only once.
First launch on Windows
Builds are not yet signed, so SmartScreen warns that the publisher is unknown. Choose More info, then Run anyway.
Linux
The packages are unsigned and no apt or dnf repository exists yet. Install the file you downloaded directly:
sudo dpkg -i Oxagen_amd64.deb
sudo rpm -i Oxagen.x86_64.rpm
chmod +x Oxagen_amd64.AppImage && ./Oxagen_amd64.AppImageCommand line
The app links oxagen and tacho into ~/.local/bin on macOS and Linux. On Windows it writes .cmd shims to a directory on your user PATH. It never asks for administrator rights, and it never replaces a file it did not write.
Open a new terminal after the first launch. On macOS and Linux, this prints both paths:
command -v oxagen tachoNext step
Set up your Oxagen account and enroll this machine.
Installing the CLI
Install the oxagen CLI with the install script, from the monorepo, as a portable single-file bundle, or from npm.
Wrap an agent
What wrapping means, how Claude Code, Codex, Cursor, and Stella get wrapped in one enrollment, and how to wrap a custom agent by calling tacho hook around its steps.