# General usage

### How to use

#### Installation

Download the `isaac` script from here [here](https://github.com/MeterianHQ/isaac-scanner/blob/main/isaac) and make it executable. A later invocation of the script will ensure, through Docker, that the scanner image [`meterian/isaac:latest`](https://hub.docker.com/r/meterian/cs-engine) is pulled. Subsequent invocations of the script will not ensure this, so newer versions of the image can be accessed through docker pull.

#### Operation

The scanner is fully integrated with the [Meterian Dashboard](https://www.meterian.com/dashboard/): every scan will be recorded and managed there.

#### Executing a scan

You can perform a scan by simply moving in the folder where the IAC code is and run the script:

```
$ isaac 
```

Note that to perform a scan a valid Meterian API token must be set as environment variable on your system. To gain a token, create one from your account at <https://meterian.com/account/#tokens>

Once you have a token populate a `METERIAN_API_TOKEN` environment variable with its value as shown below

```bash
export METERIAN_API_TOKEN=12345678-90ab-cdef-1234-567890abcdef
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meterian.io/iac-scanner/general-usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
