Metadata-Version: 2.1
Name: agent-git
Version: 0.1.0
Summary: Git for AI Memory. Prevent hallucinations with save points.
Home-page: https://github.com/moustaphamoussa/agent-git
Author: Moustapha Moussa
Author-email: moustapha.moussa@example.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# 🧠 AgentGit: Version Control for AI Memory

**Stop losing your agent's context.**

AgentGit is a lightweight, local version control system designed specifically for AI Agents. It allows LLMs to "commit" their memory state, creating save points they can roll back to if they hallucinate, crash, or get corrupted.

> "It's like `git` for your Agent's brain."

## 🚀 Why?

AI Memory (RAG, JSON, VectorDBs) is fragile.
- **Problem:** If an agent overwrites a file with bad data, that knowledge is gone forever.
- **Solution:** AgentGit snapshots the state of your memory files (`MEMORY.md`, `knowledge.json`, etc.) instantly.
- **Power Move:** Let your Agent self-correct by "undoing" its last action.

## 📦 Installation

```bash
pip install agent-git
```

*(Currently in local beta, install via source)*

## ⚡ Quick Start

### 1. Initialize
```python
from agent_git import AgentGit

# Start tracking your memory folder
memory = AgentGit(root_dir="./my_agent_workspace")
memory.init()
```

### 2. Save State (The "Save Game" Button)
```python
# Did something important? Commit it.
memory.commit(message="Learned about User's preferences", files=["user_profile.json"])
```

### 3. Time Travel (The Undo Button)
```python
# Agent messed up? Roll back.
memory.checkout("93a8571") 
```

## 🛠 CLI Usage

```bash
# Initialize
agent-git init

# Save current state
agent-git commit -m "Learned about Blender" MEMORY.md

# View history
agent-git log
# [93a8571] 2026-02-24 : Learned about Blender

# Restore
agent-git checkout 93a8571
```

## 🔮 Future Roadmap
- **Remote Sync:** Push memory to GitHub private repos.
- **Auto-Snapshot:** Hook into LangChain/AutoGPT loops.
- **Diff View:** See exactly *what* the agent forgot.

---
*Built by [Moustapha Moussa](https://github.com/moustaphamoussa) for the Open Source AI Community.*


