# 🚀 10x-Tool-Calls – Interactive AI Task Loop

**10x-Tool-Calls** is a lightweight setup designed for AI tools like **Cursor IDE** (Agent Mode), Windsurf, or any assistant supporting **tool calls**. It lets you **chain multiple tasks** together interactively using one request, saving your tool call quota and improving productivity.

---

## ✅ What It Does

This setup enables an interactive loop where the AI:

1. Completes a task.
2. Prompts you for the next instruction.
3. Continues working based on that input.
4. Repeats the cycle — all within the same session.

🔁 The loop continues until:
- You type `"stop"`, or
- The **tool call limit** is reached.

---

## 💡 Why Use It?

AI tools often have limits like:
- **500 requests/month**
- **25 tool calls per request**

Normally, even saying “hi” costs 1 request.

With **10x-Tool-Calls**:
- You use **only 1 request**
- Complete **many sub-tasks** in a loop
- Get **10x work done per session**

---

## ⚙️ How to Set It Up

### 1. Add `userinput.py` to your project root

```python
# userinput.py
user_input = input("prompt: ")
```

This file is responsible for capturing the next instruction between each AI task.

### 2. Add the rules to `.cursorrules` or project rules

Copy the contents of [`rules.md`](./rules.md) into your `.cursorrules` file, or paste them in the **Project Rules** section in Cursor IDE and set to `alwaysApply`.

---

## 🧪 Current Features

- ✅ Supports plain text input
- ❌ No image uploads or file drops yet *(coming soon)*

---

## 🧠 Example Flow

```text
You: Fix this function.
AI: Done. ✅
prompt: Add comments
AI: Added inline comments. ✅
prompt: Refactor into class
AI: Refactored. ✅
prompt: stop
AI: Session ended. 🛑
```

---

## 📂 Files

| File           | Purpose                                 |
|----------------|-----------------------------------------|
| `userinput.py` | Captures user input between AI tasks    |
| `rules.md`     | Defines looping behavior in Agent Mode  |

---

## 📸 Add an Image (Optional)

Place your screenshot in the `/assets/` folder and reference it like this:

```markdown
![How It Works](./assets/10x-loop.png)
```

---

## 🙋 Need Help?

Let me know if you'd like:
- A ZIP with these files
- A pre-generated **diagram image**
- A full working GitHub template

---

> Get more done, use fewer requests — that's the power of **10x-Tool-Calls**.