Support›Troubleshooting›Debug fig
Debug Fig
There are 2 ways of debugging Fig:
- Run
fig tools doctor - 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.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.Fig can't see that you are in a shell session.
- If you are using vim or another program in the terminal, this is expected and working correctly
- If you are seeing this in an instance where Fig should be working, check
add as shellin the debugger - If you are seeing this in instance where Fig should not be showing suggestions, check
ignorein the debugger
Fig can't link your terminal window to the TTY
Try hitting enter or running fig source.
Autocomplete is hidden
Try going to a new line by hitting ctrl+c. This may happen frequently in bash or ssh.
Everything should be working
If you're here, Fig probably isn't actually working. Email us at hello@fig.io and we'll get this fixed.
Follow the prompts to turn this off and/or visit Fig and Secure Keyboard Input
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.