coretilus is a parody of GNU Coreutils — a playful collection of typo-triggered command-line tools written in Rust like https://github.com/uutils/coreutils

Whenever you mistype something like git → gti or grep → grpe, coretilus answers instead of complaining. Each binary is intentionally useless, funny, or just delightfully absurd.

🔁 What does “tilus” mean?

t.i.l.u.s. = Tilus Is Ludicrously Useless Stuff

• A recursive acronym (because of course it is).
• It reflects the project’s spirit — ridiculously, gloriously pointless utilities.
• It's also utils with a typo.

🧩 Included commands

☑️ TODOs

• Add links/credits to original ascii authors (WIP)
• Add/Generate man pages
• Create topydex command
• Complete tests and increate test coverage
• Add brew support

💻 Install and usage

There are multiple way to install coretilus

GitHub release artifacts

Go to https://github.com/titilambert/coretilus/releases and download the archive depending on your environment, then extract it like

tar xvf coretilus-v0.0.2-linux_x86_64.tar.gz
sl
gti

Then move the binaries to folder included in you $PATH, ie /usr/local/bin

sudo cp -v sl gti /usr/local/bin/

Using deb package

Go to https://github.com/titilambert/coretilus/releases and download the package depending on your environment, then install it:

sudo dpkg -i coretilus_0.0.2-1_amd64.deb

Using rpm package

Go to https://github.com/titilambert/coretilus/releases and download the package depending on your environment, then install it:

sudo dnf install coretilus_0.0.2-1_amd64.deb

Using cargo

cargo install coretilus

Ensure $HOME/.cargo/bin is in your $PATH, then you can use the binaries do some typos

gti
sl
...

MacOs with brew

brew tap titilambert/tap
brew install coretilus

⚙️ Build

RUSTFLAGS="-C target-feature=+crt-static" cargo build

🧪 Run tests

cargo llvm-cov --doctests --open

📘 Generate docs

cargo doc --no-deps --open

Generate gifs

First, we need to compile then we use https://github.com/charmbracelet/vhs

RUSTFLAGS="-C target-feature=+crt-static" cargo build --release
docker run --rm -v `pwd`/gifs:/vhs/output -v `pwd`:/src:ro -v `pwd`/target/release:/usr/local/bin ghcr.io/charmbracelet/vhs /src/coretilus.tape
for COMMAND in $(ls -d src/commands/*/ | xargs -n1 basename)
do
docker run --rm -v `pwd`/gifs:/vhs/output -v `pwd`/src:/src:ro -v `pwd`/target/release:/usr/local/bin ghcr.io/charmbracelet/vhs /src/commands/${COMMAND}/${COMMAND}.tape
done

Optimize gifs is needed

gifsicle -O3 --colors 256 <heavy_gif>gif -o <light_gif>.gif