How To Set Up Isabelle On VSCode (Mac)

A quick tutorial to open isabelle on a VSCode style editor

System OS: macOS Sequoia 15.6.1 | Isabelle Version: Isabelle2025

Locating the Isabelle Binary #

We first want to find our Isabelle binary located in our Isabelle app. Typically this should be installed in the home Applications folder but could also be in our user Applications folder:

  • Open up terminal and try:
cd ~/../../../Applications/Isabelle2025.app/bin/

If that doesn’t work, then try:

cd ~/Applications/Isabelle2025.app/bin/

This is using your user’s applications folder.

Alternatively, if that doesn’t work, try finding where your Isabelle application is located and try moving it to your applications folder and redo the last commands.

You can find it by right clicking the Isabelle application in the dock and clicking Show in Finder.

ShowInFinder

Adding isabelle to $PATH #

So now that we’re in the directory where our isabelle binary is, we can add the directory to $PATH the environment variable that the shell uses to pull any commands we have available to us.

We can do that with:

echo "export PATH=\"$(pwd):\$PATH\"" >> ~/.zshrc

Using isabelle with VSCode #

Now, after restarting your shell, you can use the command isabelle vscode in your terminal instead of code to edit isabelle files. For example, if I’m in the directory my isabelle files are in. I can just run isabelle vscode . to open the directory.

You now may want to include some of the extensions you use in your normal VSCode Sessions though it’s a bit limited:

VSCode Extensions

You can also see the isabelle infoview by opening the command pallet and then searching for isabelle: output.