> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/sast-and-sca/prezero/tutorials/troubleshooting.md).

# Troubleshooting

This article includes troubleshooting steps you can use to identify and fix issues that may come up when using Qwiet AI by Harness.

## General troubleshooting tips <a href="#general-troubleshooting-tips" id="general-troubleshooting-tips"></a>

* Run [`sl check-environment`](broken://spaces/4t03gua31tHpZwtcczPO/pages/7xwU9QOBJFij7Vvx6iWM) to see if there are issues related to your environment (be sure to pass in your language-specific option).
* Create an environment variable called `SHIFTLEFT_SHOW_HIDDEN` and set it to `true` to show the hidden flags supported by the Qwiet CLI.
* When running `sl analyze`, include the `--cpg-output-dir` flag to specify your CPG output directory. Qwiet will place the CPG in this directory after analysis.
* Get verbose logs for additional information by including the `--verbose` and/or `--diagnostic` flags when invoking `sl analyze` (i.e., `sl analyze --verbose --diagnostic`).
* If your scan does not complete or nothing gets uploaded to Qwiet:
  * Check that your antivirus/anti-malware program isn't preventing Qwiet from performing correctly
  * (For macOS users) Ensure that Qwiet can access the necessary directory (e.g., by default, Qwiet may not be able to access files in Documents or on the Desktop without explicit permission)

## Working with monorepos <a href="#working-with-monorepos" id="working-with-monorepos"></a>

Please keep the following in mind when analyzing a monorepo:

* Depending on the size of your monorepo, you may need to scan individual components of the app (e.g., UI, API, CLI) separately instead of scanning the monorepo as a whole
* The Qwiet CLI accepts only one language at a time, so if your monorepo utilizes multiple components, you must scan each component on a per-language basis (i.e., you cannot scan JavaScript components alongside Python components)
  * While you can run sequential scans, you can also implement parallel scans with a CI system to save time
* You can use the Qwiet Dashboard's app groups functionality to group all of the individual scans for your monorepo so that you can view them simultaneously

## For Windows users <a href="#for-windows-users" id="for-windows-users"></a>

On Windows platforms, `sl.exe` doesn't auto-update. Please begin your code analysis or troubleshooting steps by checking your Qwiet version and updating if necessary:

```
sl.exe --version
```

![](/files/DfHDmRpYn5HJOmhRtTva) ![](/files/P5vj8JOtHNJWVEvAqKym)

### Path argument positioning <a href="#path-argument-positioning" id="path-argument-positioning"></a>

The path argument used with `sl analyze` should be the **last** value. If any other argument follows the path, `sl analyze` will fail.

The following is an example of an **incorrect** invocation (notice that the path argument value comes before the `--verbose` flag):

```
sl analyze --app js-example --js . --verbose
```

![](/files/DfHDmRpYn5HJOmhRtTva) ![](/files/P5vj8JOtHNJWVEvAqKym)

The correct invocation is:

```
sl analyze --app js-example --js --verbose .
```

![](/files/DfHDmRpYn5HJOmhRtTva) ![](/files/P5vj8JOtHNJWVEvAqKym)

## Specifying additional arguments to `sl analyze` <a href="#specifying-additional-arguments-to-sl-analyze" id="specifying-additional-arguments-to-sl-analyze"></a>

The `sl cli` tool accepts standard arguments, such as `--app` and `--verbose`. In addition to this, the CPG generator plugins accept additional arguments for each language. To specify these arguments, you must provide a double hyphen (`--`), then additional arguments.

For example, you can choose to ignore test and docs directories during analysis of a JavaScript app:

```
sl analyze --app js-example --js . -- * --exclude test --exclude docs
```

![](/files/DfHDmRpYn5HJOmhRtTva) ![](/files/P5vj8JOtHNJWVEvAqKym)

See the language-specific pages for your application for additional information.
