Start
Download and install
Install agex from the DMG, what happens on first launch, and how the agex command gets into your PATH.
Download
agex ships as a disk image, Agex.dmg, attached to each release on the GitHub releases page.
It runs on Macs with Apple silicon and needs macOS 11 or later.
Install
- Open
Agex.dmg. - Drag Agex onto the Applications folder in the installer window.
- Open Agex.app from Applications.
The first-launch intro
The first time you open agex, it plays a 17-second intro over your whole screen, with your desktop dimmed behind it. A lone cursor types claude, sessions wake up everywhere, and your agents' logos orbit the agex mark until it opens out into the app's window. A soundtrack plays along.
To skip to the window, press Esc or ↵, or click anywhere.
To watch it again, choose agex: Replay Welcome in the command palette (⇧⌘P). You can also start the app with the --onboarding flag:
/Applications/Agex.app/Contents/MacOS/agex --onboardingThe agex command
After the intro, agex puts an agex command in your PATH, so you can use it from any terminal. It does this again if you move the app.
It goes in the first of these folders that's in your PATH:
/usr/local/bin/opt/homebrew/bin~/.local/bin~/bin
To use a different folder, set cli.folder in settings.
If the folder is one only an administrator can write to, macOS asks for your password once. If you cancel, Add agex to PATH in Settings › Command Line turns off. Turn it back on there, or run agex install-cli. Since the command isn't in your PATH yet, run it from the app:
/Applications/Agex.app/Contents/MacOS/agex install-cliCheck that the command works:
agex versionInstall or remove it yourself
| Command | What it does |
|---|---|
agex install-cli | Puts the command in your PATH and turns on Add agex to PATH. |
agex install-cli --folder ~/bin | The same, in the folder you name. It also saves that folder as cli.folder. |
agex uninstall-cli | Removes the command and turns Add agex to PATH off. |
If the folder isn't in your PATH, agex install-cli says so, and you add it to your shell's profile.
Updates
agex checks GitHub for new releases on its own and shows an Update button when one is out. You can also run agex update. See Updates.