Bismuth

Latest version

Download Bismuth

Pick your system. The steps to install are under each download. Bismuth is early software, so expect rough edges.

macOS

macOS 13 Ventura or later, on Apple Silicon (M1 and later) or Intel.

Signed with a Developer ID and notarized by Apple.

Install

  1. Open the DMG.
  2. Drag Bismuth into Applications.
  3. Open Bismuth from Applications. The first time, macOS asks whether to open an app downloaded from the internet.

Update

Quit Bismuth, open the new DMG and drag Bismuth into Applications again. Choose Replace. Your settings stay.

Check the download

In Terminal, this prints the SHA-256 of each Bismuth DMG in Downloads. It should match the one above.

shasum -a 256 ~/Downloads/Bismuth-*.dmg

Windows

Windows 10 or 11, 64-bit.

The installer is signed with my own certificate, not one bought from a certificate authority, so each computer has to trust that certificate once before installing.

The certificate can only sign programs, not websites, and it expires in September 2031. Windows shows its thumbprint on the certificate's Details tab. It should be: C3E8 4EF4 E5E5 AE72 2810 37AD 79F3 4B93 5F76 1B4F

1. Trust the certificate (once per computer)

Open PowerShell as administrator: right-click Start and choose Terminal (Admin), or Windows PowerShell (Admin) on Windows 10. Then run these three lines. If you saved the certificate somewhere other than Downloads, change the path in the first line. 

$cer = "$env:USERPROFILE\Downloads\windows-codesign.cer"
Import-Certificate -FilePath $cer -CertStoreLocation Cert:\LocalMachine\Root
Import-Certificate -FilePath $cer -CertStoreLocation Cert:\LocalMachine\TrustedPublisher

Or click through it instead:

  1. Double-click windows-codesign.cer and choose Install Certificate.
  2. Choose Local Machine, then Next. Windows asks for administrator permission.
  3. Choose “Place all certificates in the following store”, click Browse and pick Trusted Root Certification Authorities. Click Next, then Finish.
  4. Do steps 1 to 3 again, picking Trusted Publishers this time.

On a managed PC, IT can push the certificate with Group Policy or Intune instead.

2. Install

Run Bismuth-<version>-x64.msi. If SmartScreen stops it, right-click the file, choose Properties and tick Unblock, then run it again. To check the signature first, run this in PowerShell. Its Status should be Valid. 

Get-AuthenticodeSignature .\Bismuth-<version>-x64.msi

Update

Run the new MSI. It replaces the installed version, and your settings stay.

Check the download

In PowerShell, this prints the file's SHA-256. It should match the one above.

Get-FileHash .\Bismuth-<version>-x64.msi

Linux

64-bit x86 (x86_64).

An AppImage: a single file you run directly, with nothing to install.

Install

Make the file executable, then run it:

chmod +x Bismuth-<version>-x86_64.AppImage
./Bismuth-<version>-x86_64.AppImage

If it doesn't start, run it from a terminal to see why, and email me what it says.

Update

Replace the AppImage with the new one. Your settings stay.

Check the download

This prints the file's SHA-256. It should match the one above.

sha256sum Bismuth-*.AppImage

The agents

Claude Code and Codex aren't included, and Bismuth works without them. To use them, install each one with its official installer and sign in with your own account.

If you start one in Bismuth that isn't installed, Bismuth offers to type the install command into a terminal for you.