# 🧪 TestGenie - Instantly Generate Test Cases from Your Terminal

**TestGenie** is a fast, intuitive CLI tool designed for developers who want to generate meaningful test cases from their source code - without ever leaving the terminal.

No more toggling between browser tabs, writing boilerplate, or wasting hours on trivial tests. TestGenie bridges your code with AI-powered suggestions tailored for your language and logic. 

*Currently, it uses online AI agents for test cases generation, but an offline mode is coming soon. Stay tuned!*

---

## ✨ Features

- 🔍 **Language-aware test generation** (Python, C++) [more coming soon]
- ⚡ **CLI-first experience** - stay in your flow
- 🧠 Powered by context-aware agents
- 🌐 Syncs with your online dashboard
- 🔐 Lightweight auth system
- 📊 Usage tracking (for you and your team)

---

## 🚀 Installation

TestGenie requires Python 3.8+

Install directly from PyPI:

```bash
pip install test-genie
```
---

## 🛠 Usage

Generate test cases from your CLI:

```bash
test-genie generate --path path/to/your_file.py
```

You can also specify the language explicitly:

```bash
test-genie generate -pt path/to/your_file.cpp -l cpp
```

Authenticate once:

```bash
test-genie login
```

If you don't have an account, register quickly on our website: https://thetestgenie.com

---

## 🌐 Dashboard

Visit our dashboard (https://thetestgenie.com/dashboard) to view your usage, premium status, recent generation history, and more.

---

## 💡 Use Cases

- Quickly bootstrap test coverage on legacy projects
- Generate starter tests for new logic
<!-- - Integrate with CI to flag untested critical paths -->
- Empower junior devs with example-driven TDD

---

## 📦 Publishing / Contributing

Want to contribute or self-host the backend? Instructions are coming soon. For now, feel free to mail me at wadhwakushagra01@gmail.com

---

## 📃 License

MIT © 2025 TestGenie Team