dbgagent 0.1.5

AI-powered code assistant — auto-fix, review, and simplify your entire codebase

dbgagent

AI-powered code assistant — auto-fix, review, and simplify your entire codebase.

Built by Aryan Tyagi

---

What is dbgagent?

dbgagent scans your codebase, finds problems, and fixes them with AI. Four commands:

1. fix — Auto-find files with errors, fix them
2. allfix — Scan entire codebase, find all errors, ask before fixing
3. review — Review every file, show issues as bullet points
4. simplify — Find over-engineering, simplify code

---

Install

pip install dbgagent

Upgrade

pip install --upgrade dbgagent

Uninstall

pip uninstall dbgagent

---

Setup

You need a free API key from one of these providers:

Quick start (Groq — free, fast)

1. Sign up at console.groq.com (free)
2. Copy your API key
3. Set it in a .env file in your project:

GROQ_API_KEY=your_key_here

Other providers

# OpenAI
LLM_PROVIDER=OPENAI
OPENAI_API_KEY=your_key_here

# Anthropic
LLM_PROVIDER=ANTHROPIC
ANTHROPIC_API_KEY=your_key_here

# Google Gemini (free tier)
LLM_PROVIDER=GEMINI
GEMINI_API_KEY=your_key_here

# Mistral / Codestral (free tier)
LLM_PROVIDER=MISTRAL
MISTRAL_API_KEY=your_key_here

Per-command providers (recommended)

Use the best model for each command:

# In .env — each command uses its optimal model
FIX_PROVIDER=GROQ           # fast debugging
REVIEW_PROVIDER=GEMINI      # 1M context, catches patterns
SIMPLIFY_PROVIDER=MISTRAL   # Codestral trained for refactoring
ALLFIX_PROVIDER=GEMINI      # large context for multi-file fixes

---

Usage

Fix files with errors

Scans your codebase, finds files that crash, and fixes them:

dbgagent fix
dbgagent fix ./myproject

Fix all errors

Scans entire codebase, shows all errors, asks before fixing each:

dbgagent allfix
dbgagent allfix ./myproject

Review codebase

Reviews every file, shows issues as bullet points. No code changes:

dbgagent review
dbgagent review ./myproject

Simplify code

Finds over-engineering, shows diffs, asks before applying:

dbgagent simplify
dbgagent simplify ./myproject

---

How it works

When you run a command, dbgagent:

1. Asks which directories to skip (.git, node_modules, etc.)
2. Scans all .py files in the codebase
3. For fix/allfix: runs each file, catches errors, sends to AI, gets fixes
4. For review: sends each file to AI for code review
5. For simplify: sends each file to AI for simplification
6. Shows results and asks before making changes

Your files are never modified until you say "yes".

---

Commands

Command	What it does
dbgagent fix [path]	Auto-find and fix files with errors
dbgagent allfix [path]	Scan codebase, fix all errors
dbgagent review [path]	Review codebase, show issues
dbgagent simplify [path]	Find over-engineering, simplify

All commands default to current directory if no path given.

---

Supported providers

Provider	Model	Env var	Free tier
Groq (default)	llama-3.3-70b-versatile	GROQ_API_KEY	30 RPM
OpenAI	gpt-4o	OPENAI_API_KEY	$5 credit
Anthropic	claude-sonnet-4-20250514	ANTHROPIC_API_KEY	$5 credit
Google Gemini	gemini-2.5-flash	GEMINI_API_KEY	15 RPM, 1M context
Mistral	codestral-latest	MISTRAL_API_KEY	1B tokens/month

---

License

MIT