How do I install codus?
Sign in at app.trycodus.com with the GitHub account that holds your subscription or seat, click download, then drag codus into your Applications folder. The download only works for accounts that are paying or seated, so if you land on the billing page instead of getting a file, that is the reason.
Before you start
Get Claude Code working first. Installing codus without it succeeds, but codus will have nothing to run and you will be left looking at an app that does not do anything.
You also need a GitHub account, since that is the only way to sign in. See What do I need before I can use codus?.
Steps
- Go to app.trycodus.com and sign in with GitHub.
- Click download. If you are on the marketing site instead, the download button there sends you to the same place.
- Check you are getting the right build for your Mac. See below, because getting this wrong gives you an app that will not open.
- Open the file you downloaded. A window appears with the codus icon and your Applications folder.
- Drag the codus icon onto the Applications folder.
- Open codus from Applications.
- Once it is running, right-click its icon in the dock at the bottom of your screen, then choose Options, then Keep in Dock. You will be opening it every day and this saves hunting for it.
codus is signed and notarised by Apple, so it opens normally. You should not see a warning about an unidentified developer, and you should not need to right-click to open it. If you do see that warning, you have an unofficial build, not the one from your account.
Apple Silicon or Intel?
There are two builds and only one will run on your Mac.
The download page tries to work this out for you, but it can only do that reliably in Chrome and other Chromium browsers. In Safari and Firefox it cannot tell, and quietly assumes Apple Silicon. If you have an Intel Mac and you are using Safari, that default is wrong for you.
Underneath the download button there is a small link offering the other build. Use it if you need Intel.
To check which Mac you have: Apple menu, then About This Mac. If it mentions Apple M1, M2, M3 or similar you want Apple Silicon. If it mentions an Intel processor you want the Intel build.
Why can't I just download it?
There is no public download link. Every download is checked against your account, so you need to be signed in with GitHub and hold a subscription or a seat on a team plan. Someone without one is sent to the billing page instead of getting a file.
If you were expecting to try codus before paying, that is not currently possible.
How do I know it worked?
codus opens to a full-window screen reading The code editor for AGI. with a Sign in with GitHub button. That is the normal first screen. See What happens when I first open codus?.
Updates
codus keeps itself up to date. It checks shortly after opening and periodically while running, downloads in the background, and installs when you quit. When an update is ready you will see a Restart and install button.
There is no setting to turn this off.