grafatui 0.1.12

A Grafana-like TUI for Prometheus
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

# Installation

## Homebrew

Install Grafatui with Homebrew on macOS or Linux:

```bash
brew install fedexist/grafatui/grafatui
```

## Installer Script

Install the latest prebuilt release without requiring Rust:

```bash
bash -o pipefail -c 'curl --proto =https --tlsv1.2 -LsSf https://raw.githubusercontent.com/fedexist/grafatui/main/install.sh | bash'
```

With `wget`:

```bash
bash -o pipefail -c 'wget -O- https://raw.githubusercontent.com/fedexist/grafatui/main/install.sh | bash'
```

The script supports Linux and macOS on x86_64 and ARM64. It installs to
`$HOME/.local/bin` and never invokes `sudo`. Make sure that directory is on
your `PATH`.

Set `GRAFATUI_INSTALL_DIR` to choose another destination:

```bash
bash -o pipefail -c 'curl --proto =https --tlsv1.2 -LsSf https://raw.githubusercontent.com/fedexist/grafatui/main/install.sh | GRAFATUI_INSTALL_DIR=/custom/bin bash'
```

Set `GRAFATUI_VERSION` to install a specific release. The leading `v` is
optional:

```bash
bash -o pipefail -c 'curl --proto =https --tlsv1.2 -LsSf https://raw.githubusercontent.com/fedexist/grafatui/main/install.sh | GRAFATUI_VERSION=v0.1.11 bash'
```

Every release download is verified against its published SHA-256 checksum
manifest. Installation stops if the manifest is unavailable or verification
fails.

Reviewing downloaded scripts before running them is recommended:

```bash
curl --proto '=https' --tlsv1.2 -LsSf -o install.sh https://raw.githubusercontent.com/fedexist/grafatui/main/install.sh
less install.sh
bash install.sh
```

## From Crates.io

Install the latest published release with Cargo:

```bash
cargo install grafatui
```

Grafatui currently requires Rust 1.88 or newer.

## From Source

Clone the repository and install the local checkout:

```bash
git clone https://github.com/fedexist/grafatui.git
cd grafatui
cargo install --path .
```

For development, use `cargo run` instead:

```bash
cargo run -- --prometheus-url http://localhost:9090
```

## Prebuilt Binaries

Prebuilt release assets are published on [GitHub Releases](https://github.com/fedexist/grafatui/releases) for common Linux, macOS, and Windows targets.

## Shell Completions

Grafatui can generate shell completions for Bash, Zsh, Fish, PowerShell, and Elvish.

```bash
# Bash
source <(grafatui completions bash)

# Zsh
source <(grafatui completions zsh)

# Fish
grafatui completions fish | source
```

## Man Page

Generate a man page from the CLI definition:

```bash
grafatui man > grafatui.1
```