🧰 GRIT: A Swiss Army Knife CLI Built with Rust

A modular command-line utility designed to grow with your workflow.

GRIT stands for General Rust Interface Tool — a do-it-all CLI built in Rust. It bundles small, useful tools into a single interface, ideal for developers who love working on the command line.

Originally built to scratch personal itches, GRIT aims to become a powerful companion for anyone working across different systems and environments.

🚀 Installation

From source

Make sure you have Rust installed. Then run:

cargo install --path .

Or clone it and install manually:

git clone https://github.com/SafetImamovic/GRIT
cd grit
cargo install --path .

📝 Usage

grit <command>

Example:

grit -l


  .g8"""bgd `7MM"""Mq.  `7MMF'MMP""MM""YMM
.dP'     `M   MM   `MM.   MM  P'   MM   `7
dM'       `   MM   ,M9    MM       MM
MM            MMmmdM9     MM       MM
MM.    `7MMF' MM  YM.     MM       MM
`Mb.     MM   MM   `Mb.   MM       MM
  `"bmmmdPY .JMML. .JMM..JMML.   .JMML.

  General      Rust    Interface  Tool

multi-purpose CLI utility written in Rust
(ASCII art generated @ patorjk.com [font: Georgia11])

Usage: grit [NAME] [ARGS]... [COMMAND]

Commands:
  pwd          Print the present working directory
  sysinfo      Detailed info about the system
  apps         List all installed applications
  list-secret  List all hidden commands
  help         Print this message or the help of the given subcommand(s)

Arguments:
  [NAME]     Execute a secret command defined in ~/.config/.grit-secret.toml
  [ARGS]...  Pass additional arguments to the secret command

Options:
  -h, --help     Print help
  -V, --version  Print version

Another example:

grit pwd

/home/youruser/projects/grit

🔧 Features

✅ grit pwd

Prints the current working directory as a clean, plain-text line — no formatting, no fuss.

Why this exists

PowerShell’s pwd or Get-Location returns output like this:


PS > pwd

Path
----
C:\Users\Safet\Projects\grit

This is hard to work with when scripting or copying. You’d need awkward workarounds:

(pwd).Path | clip.exe

With GRIT:

grit pwd | clip.exe

Done. Clean, portable, and pipeable.

🕵️ Secret Commands

GRIT supports secret commands defined in ~/.config/.grit-secret.toml.

Example config:


[greet]
description = "Greets the user"
command = "echo Hello from TOML"

[date]
description = "Shows the current date"
command = "date"

To list available secrets:

grit list-secrets

To run one:

grit greet

Secret commands are executed via your system shell. You can even pass additional arguments.

📦 Planned Commands

grit find <pattern> – A fast file search tool
grit sysinfo – Show basic system information
grit uuid – Generate a UUID
grit hash <file> – SHA hashing utility
...and more!

🤝 Contributing

Have a neat idea or small utility in mind? Open a PR or issue — GRIT is modular by design, so new commands are easy to integrate.

📄 License

💡 Inspiration

Like its name suggests, GRIT is about resilience and utility — a tool that grows with you and your workflow.