https://github.com/vedantjadhav701/developer-code-intelligence-agent
🧠 Local AI coding agent that autonomously finds bugs, writes fixes, self-reviews, and validates with tests. Powered by Ollama. 100% offline. Zero API costs.
https://github.com/vedantjadhav701/developer-code-intelligence-agent
ai-agent autonomous-agent code-intelligence coding-agent developer-tools local-llm offline-ai ollama python react-loop self-review
Last synced: 19 days ago
JSON representation
🧠 Local AI coding agent that autonomously finds bugs, writes fixes, self-reviews, and validates with tests. Powered by Ollama. 100% offline. Zero API costs.
- Host: GitHub
- URL: https://github.com/vedantjadhav701/developer-code-intelligence-agent
- Owner: VedantJadhav701
- License: mit
- Created: 2026-05-05T19:34:55.000Z (20 days ago)
- Default Branch: main
- Last Pushed: 2026-05-05T21:15:41.000Z (20 days ago)
- Last Synced: 2026-05-05T22:27:09.069Z (20 days ago)
- Topics: ai-agent, autonomous-agent, code-intelligence, coding-agent, developer-tools, local-llm, offline-ai, ollama, python, react-loop, self-review
- Language: Python
- Homepage:
- Size: 50.8 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# 🧠 DevAgent
### Execution-Grounded Orchestration for Autonomous Local Coding.
[**🌐 Live Site**](https://devagent-cli.vercel.app/) • [**📦 PyPI**](https://pypi.org/project/devagent-cli/) • [**📜 Docs**](https://devagent-cli.vercel.app/docs)
[](https://badge.fury.io/py/devagent-cli)
[](LICENSE)
[](https://ollama.ai)
[](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)
---
## 🛡️ 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 .
```
---
**DevAgent — Local-First. Execution-Grounded. Infrastructure-Grade.**