🧠 CLIA — Command Line Intelligence Assistant

"Why settle for boring Git summaries, when your commits could be narrated by Rajnikanth, Barney Stinson, Michael Scott, or even Groot?"

CLIA is a character-driven, AI-powered command-line tool that reads your recent Git commits and summarizes them in the voice of your favorite pop culture icons. It’s fun, productive, and will make your daily stand-ups 10x more legendary.

---

---

🪄 What Can CLIA Do?

✅ Summarizes recent Git commits
✅ Lets you choose your AI assistant's personality
✅ Supports natural time ranges (e.g. --since="last 3 months")
✅ Works with local Hugging Face-compatible models
✅ CLI-based — no internet required once the model is loaded
✅ Raw commit mode: --raw for just the facts

---

🤖 Under the Hood: Model & Inference

This CLI tool uses a fine-tuned Qwen-3 0.6B language model for commit summarization.

🔍 What is Qwen-3 0.6B?

Qwen-3 is a powerful multilingual open-source LLM family developed by Alibaba Cloud. The 0.6B version is:

• ⚙️ Lightweight (~600 million parameters)
• 🧠 Capable of efficient summarization & code understanding
• 🔄 Fine-tuned specifically on Git commit data for better daily standup summaries

💡 Why Qwen-3?

• ✅ Fast & memory-efficient — perfect for local inference
• ✅ Great performance even on small GPUs or CPU
• ✅ Fine-tuned for summarizing real-world commit logs
• ✅ Supports multi-language prompts (including English + Tamil mix)

You don’t need to connect to any external API — everything runs locally using HuggingFace Transformers and PEFT support.w

🚀 Installation

1. Clone the repo

git clone https://github.com/yourname/clia.git
cd clia

2. Install dependencies

pip install -r requirements.txt

🧪 Example Usage

python clia-cli.py path/to/your/repo --since="yesterday" --character=barney

python clia-cli.py ~/projects/awesome-app --since="last 3 months" --character=rajnikanth

python clia-cli.py . --raw

🔧 Command-Line Arguments

Argument	Type	Required	Default	Description
repo	str	✅ Yes	—	Path to the Git repository. You can use . for the current directory.
--since	str	❌ No	yesterday	Start date/time for Git logs. Accepts natural language like last week, 3 days ago, or 2023-01-01.
--until	str	❌ No	now	End date/time for Git logs. Supports formats like today, now, or a specific date.
--raw	flag	❌ No	False	If set, displays raw Git commit logs without summarization.
--character	choice	❌ No	barney	Choose your favorite assistant's personality for summaries. See supported characters below.

---

🎭 Supported Characters

Character	Voice Style / Reference
barney	Barney Stinson (HIMYM) – Legendary, sarcastic, confident
michael	Michael Scott (The Office) – Clueless, emotional, funny
walter	Walter White (Breaking Bad) – Intense, cold genius
rajnikanth	Tamil cinema superstar – Massy, powerful Tamil lines
vadivelu	Tamil comedy legend – Hilarious one-liners & reactions
dwight	Dwight Schrute (The Office) – Intense, factual, quirky
tony	Tony Stark (Iron Man) – Witty, genius, charming
groot	Groot (Marvel) – Minimalist, wholesome, tree-style logic

---

📂 Project Structure

📁 CLIA/
├── 📁 code/
│   ├── 📄 clia.py              # 🔧 Core CLIA model class (loads model, handles prompts & inference)
│   └── 📄 clia-cli.py          # 🚀 Entry-point CLI app (argument parsing, character modes, summary output)
│
├── 📁 res/                     # 🤖 Local HuggingFace-compatible LLM model directory (e.g., GGUF/QLoRA/4-bit)
│   └── (model files...)        # e.g., tokenizer.model, config.json, pytorch_model.bin
│
├── 📄 requirements.txt         # 📦 Python dependencies
├── 📄 README.md                # 📘 Project overview, usage, installation, character docs, etc.
├── 📄 .gitignore               # 🙈 Ignore virtualenvs, model files, etc.

---

🤯 Sample Output

python clia-cli.py . --since="last week" --character=dwight

⚠️ Fact: The CLIA model is loading. Faster than a bear attack.
✅ CLIA is loaded. You may proceed...

🧾 Summary:
- Refactored authentication module
- Added unit tests for payment service
- Fixed logout redirect issue

Fact: Git history never lies. Unless you're using cherry-pick. Which is deceitful. And I respect it.

---

🌟 Why This Is Cool

🎭 Turns boring commit summaries into entertainment

🔥 Perfect for standups, logs, or just flexing your vibe

🧠 Built with Transformers, 4-bit LLMs, and character-based prompting

🎉 Adds joy to daily development

---

🛠 Future Ideas

Add TTS support for character voices

Add support for OpenAI/Gemini models

Support for custom user-defined characters via JSON

VS Code extension integration

GitHub Action: auto-post summaries on PRs

---

🙌 Contribute Your Own Character!

Got a favorite character or celebrity you want to add?

Create a new entry in the CHARACTER_TEMPLATES dictionary inside clia-cli.py. PRs welcome!

---

🧑‍💻 Author

Made with ❤️ and too much caffeine by Harshit

If you enjoyed this, give the repo a ⭐ and share it with your team!