# `mix ascii.top`
[🔗](https://github.com/houllette/ascii_art/blob/main/lib/mix/tasks/ascii.top.ex#L1)

This VM in the terminal, htop-style, until you press `q` or Ctrl-C: its
schedulers as cores, its memory, its run queue as the load, its busiest
processes, and the last two minutes of memory, processes and run queue.

    mix ascii.top
    mix ascii.top --interval 2 --mode ansi256

Run in your project, it starts your application first, so what it
watches is your app at work. It is made of the pieces themselves: a
`cpu-meters` and a `sparkline` fed by `Ascii.BEAM`, in panels put
together by `Ascii.Compose`, side by side when the terminal is wide
enough, and only the cells that change are written.

## Options

  * `--interval S` - seconds between samples (default 1)
  * `--mode truecolor|ansi256|mono` - how colour is written (default
    `truecolor`)
  * `--no-parts` - in the terminal's own colours, not the pieces'
    suggested ones
  * `--paper` - colours for a light terminal
  * `--seconds S` - stop after S seconds instead of waiting for a key

---

*Consult [api-reference.md](api-reference.md) for complete listing*