> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exploratory.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

Find a fix by symptom.

## Check the state first

Run expl status. Exit code 0 from expl tools list does not mean that Desktop is connected (see [All commands](https://docs.exploratory.io/en/cli/desktop/commands.md#cmd-check)). To see what is sent and received, add `--verbose`; it prints to standard error. Review the output before you paste it anywhere.

## When you contact support

Send these to [support@exploratory.io](mailto:support@exploratory.io): the output of `expl --version`, the command you ran, the exit code and the message. Hide any token or API key.

## Symptoms and fixes

| What you see | What to do |
| - | - |
| expl: command not found | Open a new terminal and run it again. See also [Installation](https://docs.exploratory.io/en/cli/desktop/install.md). |
| The command is refused even though Desktop is running, and the message points to MCP / CLI | The CLI is off by default. In System Settings, choose MCP / CLI, turn on the switch on the CLI card and choose Save. |
| Exit code 3 | Start Exploratory Desktop and run it again. |
| Exit code 1 with PAIRING\_PENDING | You did not answer the approval screen in Desktop within 2 minutes. Answer it and run the command again (see [Get started](https://docs.exploratory.io/en/cli/desktop/get-started#steps)). |
| Exit code 4 with PAIRING\_REQUIRED | You chose Don't allow on the approval screen. For 5 minutes running the command again does not show the screen and is declined at once. Run it again after 5 minutes and allow it on the screen. |
| Exit code 4 | See the code at the end of the message in [Exit codes and errors](https://docs.exploratory.io/en/cli/desktop/exit-codes.md#action): NOT\_SIGNED\_IN, UNAUTHORIZED, PAIRING\_REQUIRED, CHANNEL\_DISABLED or PERMISSION\_DENIED. |
| PROJECT\_NOT\_OPEN | Open the project: expl project open \<id> |
| A message names a tool, such as get\_data\_frame | Run expl tools describe \<tool\_name> to see the command for that tool. |
| Odd results | Add `--verbose` to see what is sent and received. Review the output before you paste it anywhere. |

## Windows

In Windows PowerShell 5.1, a value that contains both `"` and a space breaks when you pass it directly. This is a PowerShell 5.1 bug and affects other commands such as git and node too. Pass such a value in the `--input` JSON, or use PowerShell 7.3 or later.

When you pipe into `--input` - in Windows PowerShell 5.1, run the line below first. Otherwise Japanese text becomes ?.

```sh theme={null}
$OutputEncoding = [Text.UTF8Encoding]::new($false)
```

## Related

* [Exit codes and errors](https://docs.exploratory.io/en/cli/desktop/exit-codes.md) - The list of exit codes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.