Angeo LLMs.txt — Magento 2

Generates spec-compliant llms.txt and JSONL files for ChatGPT, Claude, Gemini, and Perplexity AI visibility.

Part of the Angeo AI Commerce Suite — open-source Magento 2 modules for AI Engine Optimization (AEO).
GitHub: github.com/angeo-dev · Website: angeo.dev

Installation

composer require angeo/module-llms-txt
bin/magento setup:upgrade
bin/magento cache:flush

Usage

CLI

# Generate for all active stores
bin/magento angeo:llms:generate

# Generate for a specific store
bin/magento angeo:llms:generate --store=en_us

# Skip JSONL (llms.txt only)
bin/magento angeo:llms:generate --no-jsonl

# Skip llms.txt (JSONL only)
bin/magento angeo:llms:generate --no-llms

Admin UI

Stores → Configuration → Angeo → LLMs.txt → click Generate Now.

Cron

Runs automatically every day at 02:00 server time. Each store is emulated in AREA_FRONTEND context so that URLs and locale always resolve to correct frontend values.

bin/magento cron:run --group=default

Generated files

Files are written to pub/media/angeo/llms/ and served via a PHP controller:

Multi-store: each store gets its own file (llms_en_us.txt, llms_de.txt, etc.) served at the store's base URL.

llms.txt format

Output follows the llmstxt.org spec — H1 title, metadata block, ## sections with markdown links:

# My Store

> Store URL: https://mystore.com
> Currency: USD
> Locale: en-US

## Categories

- [All products](https://mystore.com/all-products.html)
- [Sale](https://mystore.com/sale.html)

## Products

- [Product name](https://mystore.com/product.html): 99.00 USD

## Pages

- [About us](https://mystore.com/about): About page description.

Configuration

Stores → Configuration → Angeo → LLMs.txt

Extending with custom providers

Register additional content sections via di.xml:

<type name="Angeo\LlmsTxt\Model\LlmsGenerator">
    <arguments>
        <argument name="providers" xsi:type="array">
            <item name="my_custom" xsi:type="object">Vendor\Module\Model\Llms\Providers\MyProvider</item>
        </argument>
    </arguments>
</type>

Implement Angeo\LlmsTxt\Api\ProviderInterface:

public function provide(StoreInterface $store): string
{
    return "## My Section\n\n- [Item](url): description\n\n";
}

Testing

vendor/bin/phpunit -c app/code/Angeo/LlmsTxt/phpunit.xml

The Angeo AI Commerce Suite

Free, MIT-licensed Magento 2 modules — packagist.org/packages/angeo · github.com/angeo-dev

Install the full suite:

composer require angeo/module-aeo-audit angeo/module-llms-txt angeo/module-openai-product-feed angeo/module-openai-product-feed-api angeo/module-rich-data
bin/magento setup:upgrade && bin/magento cache:flush

Changelog

See CHANGELOG.md.

License

MIT — see LICENSE

Changelog

All notable changes to this project will be documented in this file.
Format follows Keep a Changelog.
This project adheres to Semantic Versioning.

[2.1.0] — 2025-04-29

Added

• Model/Config.php — central config helper with isEnabled() and isStoreExcluded() methods
• Store-level Exclude This Store setting in admin (Stores → Configuration → Angeo → LLMs.txt)
• Global Enabled toggle now respected in CLI command, cron, generator, and controller
• Stale file cleanup — disabled or excluded stores have their generated files deleted on next generation run
• Cron: fixes admin URL being generated instead of frontend URL when cron runs
• Controller: immediate 404 if module is disabled, store is inactive, or store is excluded in config

Fixed

• getLocaleCode() returning null — replaced with ScopeConfigInterface::getValue('general/locale/code') scoped to store
• Locale format normalized to BCP 47 (en-US) instead of Magento's internal en_US format
• getBaseUrl() returning admin URL in cron/CLI context — replaced with getBaseUrl(URL_TYPE_WEB)

[2.0.0] — 2025-04-01

Added

• bin/magento angeo:llms:generate CLI command with --store, --no-jsonl, --no-llms options
• AbstractGenerator — shared base class eliminating duplicate code between LlmsGenerator and JsonlGenerator
• Single ProviderInterface — replaces two identical interfaces from v1
• Per-store exception safety — one failing store no longer blocks others; errors are logged
• Files moved to pub/media/angeo/llms/ and served via PHP controller (no direct web access to media dir)
• Admin config: product limit, JSONL toggle, per-store settings

Fixed

• JSONL providers: json_encode() was called after foreach — only the last item was encoded, all others silently dropped
• Cron namespace triple-nested (LlmsTxt\LlmsTxt\LlmsTxt\Cron) — caused PHP fatal error on every cron run
• $output initialized before store loop — store N's file contained merged content from stores 1…N
• Jsonl\CategoryProvider missing root category filter — returned system categories (ID 1, 2) and categories from all store views

Changed

• Output format now follows llmstxt.org spec: H1 title, ## sections, markdown links
• Files relocated from pub/media/ to pub/media/angeo/llms/

[1.0.0] — 2025-01-01

Added

• Initial release
• Basic llms.txt and JSONL generation for Magento 2 stores
• Cron-based daily generation
• Admin UI generation button