How do I install codus?

Sign in at app.trycodus.com with the GitHub account that holds your subscription or seat, click download, then install it: on a Mac, drag codus into your Applications folder; on Windows, run the installer you downloaded. Download access is checked against your account, including valid subscriptions, assigned seats and access grants. A Windows founder reservation has its own limited download and activation rules. If you reach Billing instead of a file, review the account and access state rather than assuming the only remedy is another purchase.

codus runs on macOS (Apple Silicon and Intel) and on 64-bit Windows 10 and 11.

Before you start

Install and configure a supported provider such as Claude Code or OpenAI Codex. Either can power the Brain and project work. Choose the installation instructions for your operating system.

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 on a Mac

1. Go to app.trycodus.com and sign in with GitHub.
2. Click download. If you are on the marketing site instead, the download button there sends you to the same place.
3. Check you are getting the right build for your Mac. See below, because getting this wrong gives you an app that will not open.
4. Open the file you downloaded. A window appears with the codus icon and your Applications folder.
5. Drag the codus icon onto the Applications folder.
6. Open codus from Applications.
7. Once it is running, click Installation guide at the far left of the bottom bar. Complete Install & set up Codus, then Prepare this Mac for building. Choose whether Claude Code or OpenAI Codex should work inside your projects.
8. Right-click the Codus icon in the dock, 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 see an unexpected security warning, stop and verify the download source and signature with support. A warning alone does not establish whether a build is official.

Steps on Windows

1. Go to app.trycodus.com and sign in with GitHub.
2. Click download. On a Windows PC the button offers the Windows build. The file is called codus-x64-setup.exe.
3. If Edge holds the download with "isn't commonly downloaded", open the Downloads list, click the three dots on the file, choose Keep, then Keep anyway. This only keeps the file on disk; nothing runs yet. See below for why Edge says this.
4. Check the signature before you open the file. This is not optional: it is the step that proves the file is the one we built.
   1. In your Downloads folder, right-click codus-x64-setup.exe and choose Properties.
   2. Open the Digital Signatures tab. Check the signature from SEARCH INTELLIGENCE LTD and that it is timestamped.
   3. Select it, click Details, and confirm the header reads "This digital signature is OK". If the tab is missing, the header says anything else, the timestamp is empty, or the signer is anyone other than SEARCH INTELLIGENCE LTD, do not open the file. Delete it and download it again from your account.
5. Only once the signature checks out, open the file. If Windows shows Windows protected your PC, click More info. The publisher shown there must be the same SEARCH INTELLIGENCE LTD, Witney, GB; if it is, click Run anyway.
6. The installer asks whether to install for everyone or only for you; keep Only for me. It then asks where to put codus, defaults to your own user folder, and does not need an administrator password.
7. When it finishes, codus opens on its own. There is also a codus shortcut on the Start menu.
8. Once it is running, click Installation guide at the far left of the bottom bar and complete Install & set up Codus.

Why Windows warns about the installer

The official Windows installer is signed and timestamped by SEARCH INTELLIGENCE LTD. A download or SmartScreen warning may still appear. There is no guaranteed date when a reputation warning disappears. Follow the signature checks above, and do not disable antivirus or other system protection to install Codus.

Neither warning is a substitute for step 4. The Publisher line on the SmartScreen screen is a summary, not a full check, which is why the Digital Signatures tab, with its timestamp and "signature is OK" state, comes first and gates whether you open the file at all.

The Windows build is for 64-bit Intel and AMD processors. On a Windows on ARM PC it runs through Windows' built-in x64 emulation.

Apple Silicon or Intel?

Choose the build that matches your Mac's chip rather than relying on emulation.

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?

Downloads are account-checked. Sign in with the GitHub account that holds the access, then check Billing if redirected. A valid grant or team seat may provide access without you personally owning a subscription. See account identity and Windows founder reservations.

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.