Metadata-Version: 2.4
Name: devagent-cli
Version: 3.7.5
Summary: A local autonomous coding agent CLI powered by Ollama.
Author: Vedant Jadhav
License: MIT
Keywords: ai,agent,coding,ollama,local,devagent,devagent-cli
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Interpreters
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich
Requires-Dist: pytest
Requires-Dist: requests
Requires-Dist: ollama
Requires-Dist: faiss-cpu
Provides-Extra: semantic
Requires-Dist: sentence-transformers; extra == "semantic"
Provides-Extra: lint
Requires-Dist: flake8; extra == "lint"
Dynamic: license-file

# 🧠 DevAgent
### Execution-Grounded Orchestration for Autonomous Local Coding.

![DevAgent Showcase](readme-image.png)

[**🌐 Live Site**](https://devagent-cli.vercel.app/) • [**📦 PyPI**](https://pypi.org/project/devagent-cli/) • [**📜 Docs**](https://devagent-cli.vercel.app/docs)

[![PyPI version](https://badge.fury.io/py/devagent-cli.svg)](https://badge.fury.io/py/devagent-cli)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Ollama](https://img.shields.io/badge/Ollama-Local%20LLM-black.svg?logo=ollama)](https://ollama.ai)
[![Safety: Sandboxed](https://img.shields.io/badge/Safety-Sandboxed-success.svg)](https://devagent-cli.vercel.app/benchmarks)

**DevAgent** is a research-grade, local-first coding agent runtime designed to bridge the gap between LLM-generated logic and production-ready execution integrity.

[Quick Start](#-quick-start) • [Architecture](#-high-integrity-architecture) • [Safety & Containment](#-safety-first-containment) • [Benchmarks](#-empirical-validation) • [Troubleshooting](docs/troubleshooting.md)

</div>

---

## 🛡️ The Problem: The "LLM-Execution Gap"
Most autonomous coding agents fail because they operate in a vacuum. They generate code that looks correct but fails at runtime due to **environment drift**, **dependency conflicts**, or **invalid execution assumptions**.

DevAgent is **Execution-Grounded Orchestration**. It doesn't just guess code; it manages the entire lifecycle of a fix:
1.  **Discovery**: Scans and maps the environment.
2.  **Isolation**: Provisions a clean, sandboxed virtual environment.
3.  **Repair**: Autonomously resolves missing dependencies.
4.  **Validation**: Verifies patches against your actual test suite.

---

## 🏗️ High-Integrity Architecture
DevAgent v3.4.1 implements a multi-layer orchestration stack designed for reliability over hype.

```mermaid
graph TD
    subgraph "Orchestration Layer"
    CLI[DevAgent CLI] --> Planner[Task Planner]
    Planner --> Retrieval[Hierarchical Retrieval: FAISS + Ripgrep]
    Retrieval --> Agent[ReAct Agent: Thought/Action/Observation]
    end

    subgraph "Execution Layer"
    Agent --> Patch[Surgical Patch Engine: Line-Level Diffs]
    Patch --> Reviewer[Self-Review Loop: APPROVED/REVISE]
    Reviewer --> Runtime[Environment Runtime]
    end

    subgraph "The Maturity Layer"
    Runtime --> Discovery[Auto-Dependency Discovery]
    Discovery --> Isolation[Venv Isolation: .tmp_envs]
    Isolation --> Repair[Autonomous Repair Loop: repair_environment]
    Repair --> Validation[Validation Engine: pytest]
    end

    Validation -- Pass --> Apply[Apply to Root Repo]
    Validation -- Fail --> Agent
```

---

## 🚀 Quick Start

### 1. Installation
Install the CLI via PyPI. Ensure [Ollama](https://ollama.ai) is running locally.

```bash
pip install devagent-cli
```

### 2. Verify Infrastructure
Check your local environment, connectivity, and dependency health.
```bash
devagent doctor
```

### 3. Run Your First Task
Execute an autonomous fix on any repository.
```bash
devagent run --task "Implement input validation for the user login" --root ./my-project
```

---

## ✨ Advanced Features

### 🔍 Hierarchical Retrieval
Instead of dumping your entire codebase into a context window, DevAgent uses a multi-tier search:
- **Global Map**: Scans the file structure to identify relevant modules.
- **Semantic Tier**: FAISS-powered vector search for conceptual matching.
- **Precision Tier**: Ripgrep for exact symbol/error discovery.

### 🏖️ Environment Isolation & Repair
DevAgent is the first local agent to treat the environment as a first-class citizen. It detects `requirements.txt` or `pyproject.toml`, creates an isolated `.tmp_envs/` runtime, and **autonomously installs missing packages** if it encounters a `ModuleNotFoundError`.

### 🩹 Surgical Patch Engine
Most agents ruin git history by rewriting entire files. DevAgent generates **line-level unified diffs**, applying only the necessary changes while preserving your code style, comments, and structure.

---

## 🔐 Safety-First Containment
We built DevAgent for engineers who care about their host systems.
- **Dry-Run Mode**: Visualize every change before it happens.
- **Atomic Snapshots**: A safety restore point is created before every execution.
- **Instant Rollback**: Revert any agent intervention with `devagent rollback`.
- **Sandbox Isolation**: Every run is contained in a separate workspace until validation passes 100%.

---

## 📊 Empirical Validation
We don't fake our success rates. DevAgent is evaluated against a public, messy benchmark suite.

| Metric | Result | Infrastructure Status |
| :--- | :--- | :--- |
| **Dependency Repair** | 95% | ✅ Production Ready |
| **Unit Bugfixes** | 80% | ✅ Highly Reliable |
| **Refactoring** | 20% | 📈 Improving (Model Bounded) |
| **Isolation Safety** | 100% | ✅ Absolute Containment |

> **Full Report**: [v3.4.1 Benchmark Analysis](docs/benchmarks.md)

---

## 🤝 Contributing
Built with a focus on **Systems Thinking**. PRs that improve orchestration reliability, environment detection, or patch precision are highly encouraged.

```bash
# Clone and Install in Editable Mode
git clone https://github.com/VedantJadhav701/Developer-Code-Intelligence-Agent.git
pip install -e .
```

---

<div align="center">
**DevAgent — Local-First. Execution-Grounded. Infrastructure-Grade.**
</div>
