I-AM-ROOT 🌱

A meditative, animated terminal experience with falling leaves & sprouting shoots.

   ██╗ █████╗ ███╗   ███╗      ██████╗  ██████╗  ██████╗  ██████╗ ████████╗
   ██║██╔══██╗████╗ ████║      ██╔══██╗██╔═══██╗██╔════╝ ██╔═══██╗╚══██╔══╝
   ██║███████║██╔████╔██║█████╗██████╔╝██║   ██║██║  ███╗██║   ██║   ██║
██  ██║██╔══██║██║╚██╔╝██║╚════╝██╔══██╗██║   ██║██║   ██║██║   ██║   ██║
╚█████╔╝██║  ██║██║ ╚═╝ ██║      ██████╔╝╚██████╔╝╚██████╔╝╚██████╔╝   ██║
 ╚════╝ ╚═╝  ╚═╝╚═╝     ╚═╝      ╚═════╝  ╚═════╝  ╚═════╝  ╚═════╝    ╚═╝
  

“Access is responsibility. Mastery is freedom.”

About • Features • Quickstart • Structure • Roadmap • Contributing

---

🧠 About

I AM Root is a living toolkit for builders who like to pop the hood: automation, security-minded scripts, and high-performance experiments that give you root-level clarity over your stack.

Not just code—an operating philosophy.

---

⚡ Features

• 🛠️ Automation Primitives: shell & Python utilities that save keystrokes.
• 🔐 Security-First Defaults: safe configs, least-privilege patterns.
• 🚀 Performance Experiments: benchmarks, profiling recipes.
• 🧩 Modular Design: drop in only what you need.
• 💡 CLI Modes: --quote, --breathe, --syscheck, --help
• 🧪 Automated Test Suite: run make test for full verification

---

🚀 Quickstart

# 1) Clone the repository
git clone https://github.com/ramangupta/I-AM-Root.git
cd I-AM-Root

# 2) (Optional) Create a Python virtualenv if needed
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate

# 3) Build the CLI project
make

# 4) Run a sample utility
./bin/iamroot --help        # Shows all available options
./bin/iamroot --quote       # Display a random quote
./bin/iamroot --breathe     # Guided breathing exercise
./bin/iamroot --syscheck    # System health check
./bin/iamroot               # Interactive mode

# 5) Run automated tests
make test

## 📂 Project Structure
I-AM-Root/
├── src/ # Core source (tools, libs, experiments)
│ ├── tools/ # CLI utilities & scripts
│ └── core/ # Reusable modules
├── scripts/ # Dev/ops scripts (bootstrap, setup, lint, etc.)
├── docs/ # Notes, design, research
├── tests/ # Unit/integration tests
├── .gitignore
└── README.md

## 🖥️ Demo
```text
$ ./bin/iamroot
Welcome to I AM Root interactive mode.
Choose an option:
1. Show a quote
2. Start breathing exercise
3. Run system check
q. Quit
> 1
"Access is responsibility. Mastery is freedom."

> 2
Breathe In... 3 2 1
Hold... 3 2 1
Exhale... 3 2 1
Repeat 3 cycles

> q
Goodbye!