# Quick start

### Command `tine run`

Define a simple pipeline description in a TOML file.

Copy the example below and save it as `cpu.toml`.

```toml
[[inlets.cpu]]
    interval = "3s"
[[flows.select]]
    includes = ["**"]
[[outlets.file]]
```

Run tine passing the `cpu.toml` path as argument.

```bash
tine run ./cpu.toml
```

Press ^C to stop.

```csv
cpu,1722171230,8.305903745046313
cpu,1722171233,11.401743796163146
cpu,1722171236,9.507754551438795
cpu,1722171239,8.965748824811843
^C
```

TINE prints out a CSV line per every 3 seconds until it is stopped by pressing ^C.

Each line in the content represents the "cpu" inlet, which generates data consisting of a timestamp in UNIX epoch time and the corresponding system CPU usage percentage.

Add `format="json"` at the end of the file, it changes the out `outlets.file` applying JSON format instead of CSV which is default.

```toml
[[outlets.file]]
    format = "json"
```

```
{"_in":"cpu","_ts":1722171856,"total_percent":8.296722122944592}
{"_in":"cpu","_ts":1722171859,"total_percent":5.32841823082893}
{"_in":"cpu","_ts":1722171862,"total_percent":5.522088353490716}
{"_in":"cpu","_ts":1722171865,"total_percent":4.525645323428138}
^C
```

### Using shebang

Edit the `cpu.toml` file and add the following line at the beginning: `#!/path/to/tine run`. Replace `/path/to/tine` with the actual path to the tine executable file on your system.

```bash
#!/usr/local/bin/tine run
[[inlets.cpu]]
    interval = "3s"
[[flows.select]]
    includes = ["**"]
[[outlets.file]]
```

The `chmod +x cpu.toml` to make it executable.

Run

```bash
$./cpu.toml
{"_in":"cpu","_ts":1722172333,"total_percent":8.287984091499398}
{"_in":"cpu","_ts":1722172336,"total_percent":6.224899598711208}
{"_in":"cpu","_ts":1722172339,"total_percent":5.395442359208408}
^C
```


---

# 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://tine.thingsme.xyz/getting-started/quick-start.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.