"A set of useless cute little CLI tools for... whatever."

Warning

USE THIS AS YOUR OWN RISK AND MENTAL, I vibe coded this FOR FUN not for real usage.

on this page

• Features
  • Minecraft
  • Uwuify
  • Coinflip
  • JSON
• Installation
  • Nix / NixOS (Flake)
  • pip / pipx
  • Prebuilt binaries
  • From source
• License

Features

Minecraft

Nether ↔ Overworld coordinates calculator

$ kawa mc ntow 727 -90.875
(x: 727 y: -90.875) in Nether is (x: 5816 y: -727) in Overworld  /ᐠ｡ꞈ｡ᐟ\

$ kawa mc ownt 727 5816
(x: 727 y: 5816) in Overworld is (x: 90.875 y: 727) in Nether  /ᐠ｡ꞈ｡ᐟ\

Level ↔ Experience calculator

$ kawa mc lvxp 21864
Level 21,864 is 2,147,604,552 Experience /ᐠ｡‸｡ᐟ\
 - I think this amount of XP can break the game :3

$ kawa mc xplv 2147483647
2,147,483,647 Experience is Level 21,863.39 /ᐠ｡‸｡ᐟ\
 - Have you ever reach this level before?

Uwuify

powered by uwuipy

$ kawa uwuify The quick brown fox jumps over the lazy dog
The q-q-quick bwown fox jyumps uvw the wazy dog

Coinflip

Flip a coin

$ kawa coinflip
Heads! As I expected..

JSON

Pretty-print JSON from a file path or a raw string.

$ kawa json pretty data.json
{
    "name": "kawa",
    "kawaii": true
}

$ kawa json pretty '{"b": 1, "a": 2}' --sort-keys
{
    "a": 2,
    "b": 1
}

Read from stdin with -:

$ echo '{"a": 1}' | kawa json pretty -
{
    "a": 1
}

Output modes

Every command accepts --json or --plain (undecorated result). The two flags are mutually exclusive.

$ kawa mc ntow 10 20 --json
{"x": 80, "z": 160}
$ kawa coinflip --plain
heads

Shell completion is available via --autocomplete.

Installation

Nix / NixOS (Flake)

Since this project is a flake, you can just run it like this:

nix run github:cherrblyria/kawa

Or install it on your system just like any other flake:

# flake.nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    kawa.url = "github:cherrblyria/kawa";
  };
}

# configuration.nix
{ pkgs, inputs, ... }: {
  environment.systemPackages = [
    inputs.kawa.packages.${pkgs.system}.default
  ];
}

pip / pipx

pipx install git+https://github.com/cherrblyria/kawa

or with uv:

uv tool install git+https://github.com/cherrblyria/kawa

Prebuilt binaries

Grab a standalone binary from the Releases page

From source

git clone https://github.com/cherrblyria/kawa
cd kawa
uv sync --dev
uv run pyinstaller kawa.spec
./dist/kawa --version

License

MIT — see LICENSE