PHPackages                             gtstudio/magento-boost - 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. gtstudio/magento-boost

ActiveMagento2-module[Utility & Helpers](/categories/utility)

gtstudio/magento-boost
======================

AI-powered development tools for Magento 2 — interactive installer, MCP server via n98-magerun2, and per-project guidelines for Claude Code, Codex, Cursor, Copilot, Gemini and Junie.

1.1.0(1mo ago)7111MITPHPPHP ^8.1

Since May 22Pushed 1mo agoCompare

[ Source](https://github.com/gabrielgts/magento-boost)[ Packagist](https://packagist.org/packages/gtstudio/magento-boost)[ Docs](https://github.com/gtstudio/magento-boost)[ RSS](/packages/gtstudio-magento-boost/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

magento-boost
=============

[](#magento-boost)

AI-powered development tools for Magento 2 — inspired by [laravel/boost](https://github.com/laravel/boost).

`magento-boost` wires your AI coding agent (Claude Code, Codex, Cursor, Copilot, Gemini, Junie) into your Magento 2 project with:

- **An MCP server** backed by [n98-magerun2](https://github.com/netz98/n98-magerun2) so your AI can run `cache:flush`, query config, inspect indexers, run DB queries, list modules, and more — directly from the chat.
- **Magento-specific guidelines** merged into `CLAUDE.md`, `AGENTS.md`, etc. — module anatomy, DI rules, plugin vs observer vs preference, declarative schema, compile/cache workflow, common footguns.
- **Theme-aware** — automatically detects Hyvä, Alpaca, or Luma and appends the right theme guidelines.
- **Project module inventory** — scans your installed custom and third-party modules and includes them in the AI context.
- **Skills** for common Magento workflows: scaffold a module, write a plugin/observer, add a DB column.
- **Extensible** — any Composer package can add its own guidelines and skills via a single `composer.json` declaration.

---

Requirements
------------

[](#requirements)

- Magento 2.4.x
- PHP 8.1+
- [n98-magerun2](https://github.com/netz98/n98-magerun2) **≥ 9.4.0** for MCP server support

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

[](#installation)

```
composer require --dev gtstudio/magento-boost
bin/magento setup:upgrade
```

If you do not already have magerun2:

```
composer require --dev n98/magerun2-dist:^9.4
```

---

Usage
-----

[](#usage)

### Interactive setup

[](#interactive-setup)

```
bin/magento boost:install
```

The command will:

1. Detect existing AI agent configs and the active theme
2. Discover any installed boost extension packages
3. Detect the magerun2 binary and version
4. Ask which AI agents to configure
5. Ask which guideline packs and skills to install
6. Ask which extensions to include (or exclude)
7. Optionally register the MCP server with a safe tool allowlist
8. Write all config files and save your selections to `boost.json`

### Re-generate after updates

[](#re-generate-after-updates)

```
bin/magento boost:update
```

Non-interactive — reads `boost.json`, re-discovers extensions, and regenerates all files. Safe to run after `composer update` or when guideline content changes.

### MCP server

[](#mcp-server)

The AI agent calls `boost:mcp` directly via stdio. You can also start it manually to test:

```
bin/magento boost:mcp
```

Pass `--preset=read-only|dev-safe|everything` to override the saved allowlist.

---

What gets configured
--------------------

[](#what-gets-configured)

AgentConfig files writtenClaude Code`.mcp.json` or `claude mcp add`, `CLAUDE.md`OpenAI Codex`.mcp.json`, `AGENTS.md`Cursor`.cursor/mcp.json`, `.cursor/rules/magento-boost.mdc`VS Code / Copilot`.vscode/mcp.json`, `.github/copilot-instructions.md`Gemini CLI`.mcp.json`, `GEMINI.md`Junie`.mcp.json`, `.junie/guidelines.md`Shared:

- `.ai/guidelines/magento-boost/` — guideline markdown files
- `.ai/skills/` — YAML-frontmatter skill files
- `boost.json` — your selections (safe to commit)

All managed regions are wrapped in `\` markers so re-runs replace only the Boost-managed content and preserve anything you write outside the markers.

---

MCP tool allowlist presets
--------------------------

[](#mcp-tool-allowlist-presets)

PresetTools exposed`read-only`sys, config list, dev list, indexer status, cache list`dev-safe` *(default)*above + cache flush, indexer reindex, setup:upgrade`everything`All magerun commands — use with caution---

Guideline packs
---------------

[](#guideline-packs)

PackContents`core` *(always)*Module anatomy, DI, plugins, observers, compile/cache workflow, schema, coding standards`frontend`Theme structure, Hyvä vs Luma, layout XML, static content`commerce-cloud``.magento/` config, deploy pipeline, ece-tools, Redis tiersTheme-specific guidelines (Hyvä, Alpaca, or Luma) are always appended automatically based on what is detected in `composer.lock`.

---

Skills
------

[](#skills)

SkillTriggers when AI is asked to…`module-scaffolding`"create a module", "scaffold a new module"`plugin-observer-recipes`"intercept method X", "hook into Y", "listen to event Z"`db-schema-changes`"add a column", "create a table", "store data for…"---

Extensions
----------

[](#extensions)

Extension packages let teams ship their own guidelines and skills alongside `magento-boost` — without forking the base package. When `boost:install` or `boost:update` runs, it scans `composer.lock` for any package that declares a `extra.magento-boost` block and merges its resources automatically.

### Creating an extension package

[](#creating-an-extension-package)

**1. Package structure**

```
your-vendor/magento-boost-rules/
  composer.json
  resources/boost/
    guidelines/
      project-conventions.md   ← merged into every agent's guideline file
    skills/
      custom-workflow/
        SKILL.md               ← copied to .ai/skills/custom-workflow/

```

**2. Declare resources in `composer.json`**

```
{
    "name": "your-vendor/magento-boost-rules",
    "description": "Project-specific AI guidelines for magento-boost",
    "type": "library",
    "license": "MIT",
    "require": {
        "gtstudio/magento-boost": "^1.0"
    },
    "extra": {
        "magento-boost": {
            "guidelines": [
                "resources/boost/guidelines/project-conventions.md"
            ],
            "skills": [
                "resources/boost/skills/custom-workflow"
            ]
        }
    }
}
```

Paths in `guidelines` and `skills` are relative to the package root. Each `skills` entry must be a directory containing a `SKILL.md` file.

**3. Install it**

```
composer require --dev your-vendor/magento-boost-rules
bin/magento boost:update
```

`boost:update` re-discovers all extensions on every run, so adding or removing an extension package and running `composer update` followed by `boost:update` is all that is needed to keep the AI context current.

### What to put in a guideline file

[](#what-to-put-in-a-guideline-file)

A guideline file is plain Markdown. Write whatever you want your AI assistant to know about the project:

```
# Project Conventions

## Module naming
All custom modules live under the `Acme` vendor namespace.
Follow the pattern `Acme_{Feature}` — no abbreviations.

## Deployment
This project deploys via GitHub Actions. Never push directly to `main`.
The staging environment is at staging.example.com.

## Third-party integrations
- Payment: uses AuthorizeNet via `paradoxlabs/authnetcim`. Do not add other payment gateways.
- Search: Elasticsearch via Smile ElasticSuite. Index names follow the pattern `magento2_{store}_{entity}`.
```

### Writing a SKILL.md

[](#writing-a-skillmd)

Skills guide the AI for specific recurring tasks. Use YAML frontmatter followed by Markdown instructions:

```
---
name: create-acme-module
description: Scaffold a new Acme module following project conventions
---

# Skill: Create Acme Module

## When to use
When asked to "create a module", "add a feature", or "scaffold Acme_{Name}".

## Steps
1. Create `app/code/Acme/{Name}/registration.php`
2. Create `app/code/Acme/{Name}/etc/module.xml`
3. Run `bin/magento setup:upgrade`
4. Confirm with `bin/magento module:status Acme_{Name}`

## Conventions
- Use `declare(strict_types=1)` in every PHP file.
- Namespace: `Acme\{Name}\`
- All DB schema changes go in `etc/db_schema.xml` — never `InstallSchema`.
```

### Excluding an extension

[](#excluding-an-extension)

During `boost:install` you can opt out of specific extensions when prompted. The excluded package names are saved in `boost.json` and respected on every subsequent `boost:update`:

```
{
    "extensions": {
        "excluded": ["your-vendor/some-extension"]
    }
}
```

You can also edit `boost.json` directly and run `boost:update`.

---

License
-------

[](#license)

MIT

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance89

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

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 ~9 days

Total

2

Last Release

54d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ab1f0030c21bebf4e87187df361e770ffaa2c0d3cdcd0cd45c77a79db5836156?d=identicon)[gtstudio](/maintainers/gtstudio)

---

Tags

mcpaimagentocodexcursorclaudemagento2boostdeveloper-toolsclaude-code

### Embed Badge

![Health badge](/badges/gtstudio-magento-boost/health.svg)

```
[![Health](https://phpackages.com/badges/gtstudio-magento-boost/health.svg)](https://phpackages.com/packages/gtstudio-magento-boost)
```

###  Alternatives

[baldwin/magento2-module-less-js-compiler

Allows Magento 2 to compile less files using the less nodejs compiler

2350.9k](/packages/baldwin-magento2-module-less-js-compiler)[mohamed-ashraf-elsaed/claude-agent-sdk-laravel

Anthropic Claude Agent SDK for PHP & Laravel — build AI agents with tool use, sandboxing, MCP servers, subagents, hooks, and structured output via the Claude Code CLI

161.1k](/packages/mohamed-ashraf-elsaed-claude-agent-sdk-laravel)[dykyi-roman/awesome-claude-code

Claude Code extension for PHP: audits (architecture, DDD, security, performance, PSR, design patterns, Docker, CI/CD, tests, docs), 3-level code review, automated bug fix, generators (DDD, CQRS, GoF patterns, PSR, tests, documentation, Docker, CI/CD), code explanation, refactoring. 26 commands, 62 agents, 259 skills.

891.2k](/packages/dykyi-roman-awesome-claude-code)[mage-os/module-llm-txt

AI-powered LLMs.txt generation for Magento 2 / Mage-OS stores. Help AI systems understand your store with OpenAI-generated content.

234.4k](/packages/mage-os-module-llm-txt)[angeo/module-llms-txt

Magento 2 module for AI Engine Optimization (AEO). Generates spec-compliant llms.txt and llms-full.txt per llmstxt.org standard, plus streaming JSONL for vector indexing. Multi-store, multi-website, CLI, cron, async admin UI, Page Builder-aware sanitization, customer-group pricing, atomic writes, ETag/Cache-Control, .md mirrors.

111.1k](/packages/angeo-module-llms-txt)

PHPackages © 2026

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