# TTY Mode

## EXPERIMENTAL!

> TTY-mode is NOT complete and is highly-experimental. That said, it is mostly working as of the latest release if you want to give it a go. Use it at your own discretion.

The interleaved output format is very helpful for logs when using targets on a CI system, such as Jenkins, but it can sometimes be a little hard to follow as a user. Also, what if your target results in an interactive TTY? For these reasons, targets has an experiment TTY-mode which will multiplex parallelized output streams.

Consider we were to execute two parallel targets which launched a docker TTY like so:

```
mycli docker.run,docker.run --docker.tty --docker.interaction --docker.name busybox -- --tty
```

> If you add a `--` at the end of your command, any additional arguments will be passed down directly to the framework. For example, for TTY-mode you can add `-- --tty` at the end of any command. This tells targets to run in "tty" mode.

You would then be presented with a multiplexed terminal which looks something like this:

```
┌───────────────────────┐┌───────────────────────────────────────────────────────┐
│docker.run,docker.run  ││                                                       │
│                       ││docker →  Running: docker run --tty busybox:latest     │
│                       ││docker →  Running: docker run --tty busybox:latest     │
└───────────────────────┘│                                                       │
┌───────────────────────┐│                                                       │
│                       │└───────────────────────────────────────────────────────┘
│docker.run - started   │┌─docker────────────────────────────────────────────────┐
│docker.run - started   ││/ #                                                    │
│                       ││                                                       │
│                       ││                                                       │
│                       ││                                                       │
│                       ││                                                       │
│                       │└───────────────────────────────────────────────────────┘
│                       │┌─docker────────────────────────────────────────────────┐
│                       ││/ #                                                    │
│                       ││                                                       │
│                       ││                                                       │
│                       ││                                                       │
│                       ││                                                       │
└───────────────────────┘└───────────────────────────────────────────────────────┘
```

To move between the panes, just hit `Ctrl-N` or `Ctrl-P`. To exit, hit `Ctrl-C` or `Ctrl-Q`.

Given your target has returned working TTY, as shown above, you can even interact with the shell inside any of the multiplexed panes.