# Example: running the client in interactive mode

Let's run this example with a simple open source project you can find on GitHub; for this exercise let's assume also you already downloaded and stored the client under `~/apps/Meterian-cli.jar`&#x20;

First, let's clone the project from GitHub, for example Eclipse Vert.x:

```
$ git clone git@github.com:eclipse/vert.x.git

Cloning into 'vert.x'...
remote: Counting objects: 110122, done.
remote: Compressing objects: 100% (86/86), done.
remote: Total 110122 (delta 81), reused 145 (delta 61), pack-reused 109941
Receiving objects: 100% (110122/110122), 94.48 MiB | 1.20 MiB/s, done.
Resolving deltas: 100% (57513/57513), done.
Checking connectivity... done. 
```

Now, let's move into the folder and launch the client with the default configuration:

```
$ cd vert.x
$ java -jar ~/apps/meterian-cli.jar

Meterian Client v0.1
- running locally: yes
- interactive mode: on
- working on folder: /tmp/vert.x
Checking folder...
Folder /tmp/vert.x contains a viable project!
Authorizing the client...
I cannot find a valid authorization token: I will open the browser so
obtain one
Please login as usual with your selected credentials
Created new window in existing browser session. 
```

As you can see the client introduced itself and then, as it's the first time it is launched, is opens a new browser window for you to login with your credentials and authorize it. After a successful login the client will proceed to collect the dependencies, using your local Maven installation (you can also move this task server side, but it's a good idea to execute this step on your local environment). After collecting the dependencies it will upload them to the Meterian servers, where they will be analysed. The client will also output information about the status of the process.

```
Client successfully authorized
Loading build status...
No build running found!
Requesting build...
Build allowed
Running maven locally...
- maven: loading dependency tree...
- maven: dependencies generated...
Execution successful!
Uploading dependencies information - 63 found...
Done!
Starting build...
Current status: in preparation
Current status: "cleaning" - last updated at "2017-07-01T16:09:02.189"
```

When the work on the server is finished the client will emit the result of the analysis. The client will also output information about the status of the process, and provide you a link to access the report.

```
Final results:
- report: "OK"
- security: "0"
- stability: "88"
- timestamp: "2017-07-01 16:09:02"
Full report available at:
https://www.meterian.com/projects.html?pid=2fae2c4c-e22b-445c-a2cbcc7796d6c579&branch=master&login=true
```

Opening the link will force you through a login page: please make sure to use a set of credentials associated to your account to access, otherwise you will not be able to see the report.


---

# 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/the-client/using-the-client/example-running-the-client-in-interactive-mode.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.
