# Usage

After installing it, you may call `jstr` providing the [Options](/jstr/usage/options.md#help) argument to understand a bit more about its options and such:

```bash
jstr --help
```

{% hint style="info" %}
You can use `NO_COLOR=1` to turn off colors from the help message
{% endhint %}

This will print some examples and description to available options, but `jstr` is quite simple to understand, it will basically:

1. Receive a JSON input;
   1. By simply providing the relative file path: `jstr my-file.json`;
   2. Or using the [Options](/jstr/usage/options.md#input) option to receive your JSON from a piped command (`stdin`).
2. Apply any transformation based on the [Options](/jstr/usage/options.md) provided;
3. Run the [Callback Parser](/jstr/usage/callback-parser.md) *(if provided)* passing the result from step 2;
4. Output the data by printing it (or copy to clipboard, if you pass the [Options](/jstr/usage/options.md#copy) option).

As you can see, all options & handler are optional, making `jstr` quite a flexible tool.

And as usual, since `jstr` will by default print the result to your terminal, you can use it to create new JSON files (or whatever file type you want):

```bash
jstr ... > my-new-file.json
```


---

# 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://jliocsar.gitbook.io/jstr/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.