PHPackages                             telescopeai/autodebug - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. telescopeai/autodebug

ActiveLibrary[Debugging &amp; Profiling](/categories/debugging)

telescopeai/autodebug
=====================

AI-powered auto-debug &amp; auto-fix system for Laravel. Monitors Telescope exceptions, analyzes them with AI, generates fixes, and creates GitHub PRs automatically.

00PHP

Since Mar 12Pushed 1w agoCompare

[ Source](https://github.com/avinash-borse/telescope_autodebug)[ Packagist](https://packagist.org/packages/telescopeai/autodebug)[ RSS](/packages/telescopeai-autodebug/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

🔭 TelescopeAI AutoDebug
=======================

[](#-telescopeai-autodebug)

**AI-powered auto-debug &amp; auto-fix for Laravel.** Monitors Telescope exceptions, analyzes them with multiple AI providers (OpenAI, Claude, Gemini, or local Ollama), generates code fixes, and creates GitHub PRs automatically.

[![Laravel](https://camo.githubusercontent.com/0fdd2ad6f71e1bec424f883f9bbe83c0ae9e2b7961e53058be0c2c57fde63dc4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3130253230253743253230313125323025374325323031322d4646324432303f6c6f676f3d6c61726176656c)](https://laravel.com)[![PHP](https://camo.githubusercontent.com/f63016028e316c15bc11280643beebe09fba1e69d8ab48d3d29ca8459976d3a9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312b2d3737374242343f6c6f676f3d706870)](https://php.net)[![License](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](LICENSE)

---

✨ Features
----------

[](#-features)

- 🔍 **Automatic Exception Detection** — Polls Telescope for new exceptions
- 🧠 **Multi-AI Engine** — Supports **OpenAI**, **Anthropic (Claude)**, **Google Gemini**, and **Ollama** (Local/Free)
- 🛠️ **Auto-Fix Generation** — AI suggests code patches with search/replace
- 🚀 **GitHub PR Creation** — Pushes fixes as PRs with detailed descriptions
- �️ **Terminal Diff Preview** — View suggested changes directly in your console
- �📊 **Web Dashboard** — View exceptions, AI analysis, confidence scores, and PR status
- 🔔 **Notifications** — Slack, email, and database logging
- 🔒 **Safety Guards** — Protected paths, deduplication, rate limiting, confidence thresholds

---

📦 Installation
--------------

[](#-installation)

### 1. Require the package

[](#1-require-the-package)

```
composer require telescopeai/autodebug
```

### 2. Run the install command

[](#2-run-the-install-command)

```
php artisan autodebug:install
```

### 3. Configure your `.env`

[](#3-configure-your-env)

#### Option A: Local Ollama (Free &amp; Private)

[](#option-a-local-ollama-free--private)

Best for internal development. No API keys required.

```
AUTODEBUG_AI_PROVIDER=ollama
AUTODEBUG_OLLAMA_BASE_URL=http://localhost:11434
AUTODEBUG_OLLAMA_MODEL=deepseek-coder:6.7b
```

#### Option B: Google Gemini

[](#option-b-google-gemini)

Highly capable with generous free tiers.

```
AUTODEBUG_AI_PROVIDER=google
AUTODEBUG_GOOGLE_API_KEY=your-gemini-key
AUTODEBUG_GOOGLE_MODEL=gemini-2.0-flash
```

#### Option C: OpenAI / Anthropic (Claude)

[](#option-c-openai--anthropic-claude)

Professional grade models.

```
# For OpenAI
AUTODEBUG_AI_PROVIDER=openai
AUTODEBUG_OPENAI_API_KEY=sk-your-key-here

# For Anthropic
AUTODEBUG_AI_PROVIDER=anthropic
AUTODEBUG_ANTHROPIC_API_KEY=sk-ant-your-key-here
```

### 4. GitHub Configuration

[](#4-github-configuration)

Required only if you want automatic PR creation.

```
AUTODEBUG_GITHUB_ENABLED=true
AUTODEBUG_GITHUB_TOKEN=ghp_your-github-token
AUTODEBUG_GITHUB_OWNER=your-org-or-username
AUTODEBUG_GITHUB_REPO=your-repo-name
```

---

🚀 Usage
-------

[](#-usage)

### CLI Commands

[](#cli-commands)

```
# Run analysis (Dry run doesn't create PRs)
php artisan autodebug:analyze --dry-run

# 🔥 See the file changes in terminal
php artisan autodebug:analyze --dry-run --diff

# Force analysis even if recently analyzed
php artisan autodebug:analyze --force
```

---

⚙️ Configuration
----------------

[](#️-configuration)

OptionDefaultDescription`ai.provider``openai``openai`, `anthropic`, `google`, or `ollama``analysis.min_confidence_for_pr``75`Minimum AI confidence to create a PR`analysis.max_calls_per_hour``10`Rate limit for AI API calls`analysis.dry_run``false`Global dry run mode`safety.protected_paths``[...]`Files the AI is never allowed to touch---

🧪 Prerequisites
---------------

[](#-prerequisites)

- **PHP 8.1+**
- **Laravel 10, 11, or 12**
- **Laravel Telescope**
- **GitHub Personal Access Token** (for PRs)

---

📄 License
---------

[](#-license)

MIT License. See [LICENSE](LICENSE) for details.

###  Health Score

20

—

LowBetter than 17% of packages

Maintenance64

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f0174dc42be7ffe9403d6e3ae4304d916639c168ac2924b40aacb0714220f4f1?d=identicon)[avinash-borse](/maintainers/avinash-borse)

---

Top Contributors

[![avinash-borse](https://avatars.githubusercontent.com/u/100289116?v=4)](https://github.com/avinash-borse "avinash-borse (3 commits)")

### Embed Badge

![Health badge](/badges/telescopeai-autodebug/health.svg)

```
[![Health](https://phpackages.com/badges/telescopeai-autodebug/health.svg)](https://phpackages.com/packages/telescopeai-autodebug)
```

###  Alternatives

[filp/whoops

php error handling for cool kids

13.3k394.4M1.3k](/packages/filp-whoops)[symfony/stopwatch

Provides a way to profile code

2.8k379.8M774](/packages/symfony-stopwatch)[composer/xdebug-handler

Restarts a process without Xdebug.

2.6k390.6M73](/packages/composer-xdebug-handler)[beyondcode/laravel-dump-server

Symfony Var-Dump Server for Laravel

1.6k42.1M153](/packages/beyondcode-laravel-dump-server)[fruitcake/laravel-debugbar

PHP Debugbar integration for Laravel

19.1k253.2k13](/packages/fruitcake-laravel-debugbar)[spatie/ignition

A beautiful error page for PHP applications.

510143.5M56](/packages/spatie-ignition)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
