PHPackages                             maarheeze/codegraph-laravel - 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. [Utility & Helpers](/categories/utility)
4. /
5. maarheeze/codegraph-laravel

ActiveLibrary[Utility & Helpers](/categories/utility)

maarheeze/codegraph-laravel
===========================

laravel-specific extractors for codegraph code indexing

1.5.3(1mo ago)273MITPHPPHP ^8.3

Since May 20Pushed 1mo agoCompare

[ Source](https://github.com/maarheeze/codegraph-laravel)[ Packagist](https://packagist.org/packages/maarheeze/codegraph-laravel)[ RSS](/packages/maarheeze-codegraph-laravel/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (17)Versions (11)Used By (0)

maarheeze/codegraph-laravel
===========================

[](#maarheezecodegraph-laravel)

**Instant code understanding for Laravel applications.**

This package extends [maarheeze/codegraph](https://github.com/maarheeze/codegraph) to automatically extract and index Laravel patterns—routes, models, services, and dependencies. Understand your codebase instantly without guessing, grepping, or slow IDE searches.

Why Use It?
-----------

[](#why-use-it)

**Answer questions about your Laravel app in milliseconds.**

- **Where is X bound?** — Find service bindings instantly
- **What breaks if I change this?** — See all callers, relations, and dependents
- **How does this route work?** — Trace the full call chain from route → controller → models → queries
- **Where is this model used?** — Find all relations and eager-loading patterns
- **What models relate to this one?** — See all hasMany, belongsTo, morphs, and polymorphic relations at a glance

**How it helps:**

- ⚡ **Faster refactoring** — Know exactly what breaks before you change it
- 💰 **Cheaper AI assistance** — Feed Claude accurate, structured data instead of raw file contents
- 🔍 **Offline navigation** — No IDE plugin or running app needed; index once, query forever
- ✨ **Automatic extraction** — No manual mapping; parses your actual code structure (AST-based, not regex)
- 🤖 **Works with Claude Code, Cursor, and any AI** — MCP protocol integration for context-aware code assistance

What It Extracts
----------------

[](#what-it-extracts)

This package extends CodeGraph with Laravel-aware extraction:

- **Routes** — All route definitions with HTTP methods and controller handlers
- **Eloquent Relations** — Model relationships (hasMany, belongsTo, hasOne, hasManyThrough, belongsToMany, morphMany, morphTo)
- **Service Bindings** — Service container bindings (bind, singleton, scoped, instance, factory)
- **Call Graph** — Complete call graphs across your codebase
- **Inheritance & Traits** — Class hierarchies and trait usage

Installation
------------

[](#installation)

```
composer require maarheeze/codegraph-laravel --dev
```

The package auto-registers via Laravel's service provider system. No additional configuration needed.

Usage
-----

[](#usage)

### Initialize and Index Your Application

[](#initialize-and-index-your-application)

First, initialize CodeGraph and publish the MCP routes:

```
php artisan codegraph:init
```

Then, index your application:

```
php artisan codegraph:index
```

The `init` command:

- Sets up the `.codegraph/index.sqlite` database
- Auto-detects your environment (Sail, Docker, or plain PHP)
- Generates `.mcp.json` with the correct startup command
- Publishes `routes/ai.php` to register the MCP server
- Registers the CodeGraph MCP server in Claude Code settings

The `index` command scans your `app/` and `routes/` directories and extracts all Laravel patterns into the database. This directory is auto-generated and should be added to `.gitignore`.

### View Indexing Status

[](#view-indexing-status)

```
php artisan codegraph:status
```

Shows what was extracted: routes, relations, service bindings, and other patterns.

Using Your Index
----------------

[](#using-your-index)

Once indexed, your code graph is ready to use:

- **With Claude Code** — Automatically configured via `.mcp.json` and Laravel MCP. Open Claude Code and it will discover the MCP server and start it automatically. Claude Code will proactively offer the 3 Laravel-specific tools below when you ask questions about your codebase.
- **Programmatically** — Query the SQLite index directly in `.codegraph/index.sqlite` for custom tools and workflows

### MCP Tools for Claude Code

[](#mcp-tools-for-claude-code)

After running `codegraph:init` and `codegraph:index`, Claude Code has access to **3 Laravel-specific MCP tools** powered by Laravel MCP:

#### `codegraph_find_route`

[](#codegraph_find_route)

Find Laravel routes by URL pattern or name.

```
Pattern: "users" → Returns all routes matching "users"
Pattern: "user.show" → Returns the named route "user.show"

```

**Returns:** Route path, HTTP method, controller method, file location

#### `codegraph_find_model`

[](#codegraph_find_model)

Find Eloquent models and their relations.

```
Name: "User" → Returns the User model with all its relations

```

**Returns:** Model FQN, file path, all hasMany/belongsTo/morphs relations with related models

#### `codegraph_find_service`

[](#codegraph_find_service)

Find service container bindings.

```
Name: "auth" → Returns all services bound to "auth"
Name: "UserRepository" → Returns where UserRepository is bound

```

**Returns:** Binding key, concrete class, service provider, file location

These tools work alongside CodeGraph's 5 core tools (search, callers, callees, blast\_radius, search\_chunks) to give Claude Code complete understanding of your Laravel application. The MCP server is automatically started using Laravel's native MCP framework based on your environment (Sail, Docker, or plain PHP) as detected during `codegraph:init`.

### Automatic Indexing on Install

[](#automatic-indexing-on-install)

To automatically initialize and index your codebase after dependencies are installed or updated, add the following to your `composer.json`:

```
{
  "scripts": {
    "post-autoload-dump": [
      "@php artisan codegraph:init || true",
      "@php artisan codegraph:index || true"
    ]
  }
}
```

This ensures your code graph is initialized and stays in sync whenever dependencies change or the codebase is freshly checked out.

Architecture
------------

[](#architecture)

The package implements the CodeGraph plugin system:

- **LaravelPlugin** — Registers Laravel-specific extractors
- **RouteExtractor** — Parses route definitions
- **EloquentRelationExtractor** — Detects model relationships
- **ServiceProviderBindingExtractor** — Captures service bindings
- **LaravelIndexingService** — Wraps core IndexingService with Laravel defaults
- **LaravelStatusService** — Provides query interface for extracted data

All extractors extend `BaseAstVisitor` and work with the AST (Abstract Syntax Tree) to ensure accuracy.

How It Works
------------

[](#how-it-works)

1. **Register plugin** — LaravelPlugin registers all extractors with CodeGraph
2. **Scan files** — Discovers and parses PHP files in `app/`, `routes/`, and configurable directories
3. **Extract patterns** — Each extractor identifies Laravel-specific patterns in the AST (Abstract Syntax Tree)
4. **Build graph** — Creates nodes for routes, models, services, and edges for dependencies
5. **Persist index** — Stores the complete code graph in SQLite for fast, offline querying
6. **Resolve references** — CodeGraph resolves all cross-file references automatically

The index is **incremental** — subsequent runs only re-scan changed files, keeping indexing fast even on large codebases.

Use Cases
---------

[](#use-cases)

- **Impact Analysis** — Answer "what breaks if I change this?" before you refactor
- **Dependency Discovery** — Understand the full dependency graph of a feature
- **Refactoring Safety** — See all callers, relations, and bindings before making changes
- **Onboarding** — New developers understand the codebase structure instantly
- **Documentation** — Auto-generate architecture diagrams from actual code
- **IDE & Tools** — Integrate with Claude Code, custom scripts, or build tools for context-aware assistance
- **Code Review** — Verify that refactors are complete and consistent

License
-------

[](#license)

MIT

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance92

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~3 days

Total

10

Last Release

37d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/734972e64c460b2142b0b04b4f40aa30077c5dd1915411b486ec72efcae3c3bf?d=identicon)[wietsewarendorff](/maintainers/wietsewarendorff)

---

Top Contributors

[![wietsewarendorff](https://avatars.githubusercontent.com/u/313525?v=4)](https://github.com/wietsewarendorff "wietsewarendorff (14 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/maarheeze-codegraph-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/maarheeze-codegraph-laravel/health.svg)](https://phpackages.com/packages/maarheeze-codegraph-laravel)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[laravel/boost

Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code.

3.5k21.5M673](/packages/laravel-boost)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[laravel/surveyor

Static analysis tool for Laravel applications.

86121.4k14](/packages/laravel-surveyor)[zidbih/laravel-deadlock

Make temporary Laravel workarounds expire and fail CI when ignored.

985.4k](/packages/zidbih-laravel-deadlock)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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