Appachi Tools

Kaval Privacy Policy

Last updated: (Kaval 0.2.0)

TL;DR

Kaval reads port and process information from your own machine in real time. It stores nothing, sends nothing over the internet, and has no telemetry.

What Kaval accesses

Kaval reads the following from your operating system in real time: listening ports, their protocols (TCP/UDP) and bind addresses; process IDs, names, command lines, working directories, owners and parent processes; connections made to those ports; CPU and memory usage and process uptime. To name the project a process belongs to, it looks for the git repository folder its working directory sits in. All of it is read-only, held in memory while Kaval runs, and discarded when it exits.

What Kaval connects to

Kaval never connects to the internet. It only makes connections to your own machine:

  • To tell whether a port is in use when the process holding it is hidden from you (another user's process), kav check, kav kill and kav wait try a connection to that port on your machine.
  • When you ask for a health check (kav check --probe, or p in the interactive view), Kaval connects to the listener and, for web ports, sends an HTTP HEAD / request.
  • kav pick briefly opens candidate ports on your machine to make sure they are free.

Programs Kaval runs

  • If the Docker command-line tool is installed, Kaval runs docker ps to name the containers that publish ports, and runs docker stop only when you stop a container's port. These commands talk to whichever Docker daemon your Docker CLI is set up to use.
  • In the interactive view, copying uses your system clipboard tool (pbcopy, wl-copy, xclip or xsel) or your terminal's clipboard, and opening a page uses your browser via open or xdg-open.
  • To pick a light or dark theme, Kaval asks your terminal for its background colour.

What Kaval does not do

  • Does not store any data to disk
  • Does not create config files, logs or databases
  • Does not connect to the internet or check for updates
  • Does not send telemetry, analytics, or crash reports
  • Does not collect personal information or require an account

Open source

Kaval is fully open source under the MIT license. You can audit every line at github.com/AppachiTech/kaval.

Contact

Questions? Reach out at madhu@appachi.tech.