From a928f85875e1b520468cb0f077c31b5e9ba9ad86 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sun, 1 Nov 2026 16:28:16 +0000
Subject: [PATCH] Document how to clone and run the included tests

Replace the README intro with the approved description and install
commands. Python 3.11+ and the dev extra already match this repo.

Co-authored-by: Dor Ingber  <Doringber@users.noreply.github.com>
---
 README.md | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 7b94340..05663e8 100644
--- a/README.md
+++ b/README.md
@@ -11,11 +11,6 @@
         |___/
 </pre>
 
-<p align="center">
-  <strong>Shared pytest framework for testing AI agents.</strong><br>
-  Mock in CI · live HTTP when you opt in · HTML reports humans actually open.
-</p>
-
 <p align="center">
   <a href="#quick-start">Quick start</a> ·
   <a href="#agent-assertions-reference">Assertions</a> ·
@@ -30,6 +25,21 @@
   <img src="https://img.shields.io/badge/version-0.1.2-blue" alt="0.1.2">
 </p>
 
+Test what your AI agent actually does, not just what it says. Check tool calls, their order and arguments, and side effects, with a self-contained HTML report.
+
+Run the included tests (Python 3.11+):
+
+```bash
+git clone https://github.com/Doringber/agent-test-kit.git
+cd agent-test-kit
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+Tests run against mocks by default. Live tests are opt-in. See Quick start to test your own agent.
+
 ---
 
 ## The report is the product