SupportTroubleshootingDebug fig

Debug Fig

There are 2 ways of debugging Fig:

  1. Run fig tools doctor
  2. Built-in debugger. Click on your Terminal, then click on the Fig icon ◧ in your macOS status bar.

Doctor

Running fig doctor should be step #1 of troubleshooting Fig. Fig doctor will identify problems and either fix the issue for you, or direct you to the right place for guidance.

fig tools doctor

Built-in Debugger

Fig's debugger can give some basic information that can help diagnose common issues.


Click on your Terminal, then click on the Fig icon ◧ in your macOS status bar.

Debugger States

Fig has lost the shell session context

This can also appear when we cannot connect to wifi and load up the autocomplete app.



Click on another window (like Chrome or the desktop) then back to your

terminal.

Follow the prompts to re-enable Fig's accessibility permissions in system preferences.


Fig relies on the macOS accessibility API to interact with your terminal window. If this isn't enabled, Fig will not be able to place the popup in the correct place.

There was an installation error. Run this script in your terminal:

~/.fig/tools/install_and_upgrade.sh

This will reinstall Fig, its autocompletion library, shell and terminal integrations, and upgrade to the newest version.

Reinstallation can fix issues with missing autocompletion specs, Fig not working with different terminals, and problems with the path.