PHPackages                             romansh/laravel-creem-agent - 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. [Logging & Monitoring](/categories/logging)
4. /
5. romansh/laravel-creem-agent

ActiveLibrary[Logging & Monitoring](/categories/logging)

romansh/laravel-creem-agent
===========================

Autonomous AI agent for Creem.io store monitoring — heartbeat, proactive workflows, notifications, chat interface

1.2.8(1mo ago)03↑2900%MITPHPPHP ^8.2

Since Mar 28Pushed 1mo agoCompare

[ Source](https://github.com/romansh/laravel-creem-agent)[ Packagist](https://packagist.org/packages/romansh/laravel-creem-agent)[ RSS](/packages/romansh-laravel-creem-agent/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (10)Versions (3)Used By (0)

Laravel Creem Agent
===================

[](#laravel-creem-agent)

Autonomous AI agent for Creem.io store monitoring — heartbeat engine, proactive workflows, multi-store support, chat interface, and notifications.

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

[](#installation)

```
composer require romansh/laravel-creem-agent
```

Setup
-----

[](#setup)

```
php artisan vendor:publish --tag=creem-agent-config
php artisan vendor:publish --tag=creem-agent-migrations
php artisan migrate
php artisan creem-agent:install
```

Quick Start
-----------

[](#quick-start)

```
# Run first heartbeat
php artisan creem-agent:heartbeat

# Chat with agent
php artisan creem-agent:chat "how many active subscriptions?"

# Check agent status
php artisan creem-agent:status

# Run for all stores
php artisan creem-agent:heartbeat --all-stores
```

Configuration
-------------

[](#configuration)

- See `config/creem-agent.php` for:
- Multi-store setup
- Notification channels (Telegram)
- Telegram ownership mode: `laravel` or `openclaw`
- Natural-language routing via Laravel AI SDK
- Heartbeat frequency per store
- Quiet hours
- OpenClaw integration

AI / Natural Language Routing
-----------------------------

[](#ai--natural-language-routing)

The chat interface now uses `laravel/ai` to classify natural-language requests into agent intents, with the legacy regex parser kept as a fallback.

Example `.env` settings:

```
CREEM_AGENT_LLM_ENABLED=true
CREEM_AGENT_LLM_PROVIDER=openai
CREEM_AGENT_LLM_MODEL=gpt-5.4
CREEM_AGENT_LLM_TIMEOUT=30

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
OPENROUTER_API_KEY=
OLLAMA_BASE_URL=http://localhost:11434
```

Provider switching is done through `CREEM_AGENT_LLM_PROVIDER`, while model switching is done through `CREEM_AGENT_LLM_MODEL`.

When `CREEM_AGENT_TELEGRAM_MODE=openclaw`, Telegram should be configured in OpenClaw gateway using the native channel model from . The package can render a starter snippet with:

```
php artisan creem-agent:openclaw-telegram-config
```

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

[](#architecture)

Uses a **CLI Facade** (`CreemCli`) that auto-detects:

1. Native `creem` CLI (brew) → fast shell exec with `--json`
2. `laravel-creem-cli` → in-process SDK calls (fallback)

Transparent failover between backends.

Proactive Workflows
-------------------

[](#proactive-workflows)

- **FailedPaymentRecovery** — alerts on `past_due` subscriptions
- **ChurnDetection** — detects cancellation spikes
- **RevenueDigest** — summarizes new transactions
- **NewCustomerWelcome** — celebrates growth
- **AnomalyDetection** — flags unusual metric drops

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance90

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

Unknown

Total

1

Last Release

46d ago

### Community

Maintainers

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

---

Top Contributors

[![romansh](https://avatars.githubusercontent.com/u/10420314?v=4)](https://github.com/romansh "romansh (11 commits)")

---

Tags

laravelmonitoringaiAgentsaascreemheartbeat

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/romansh-laravel-creem-agent/health.svg)

```
[![Health](https://phpackages.com/badges/romansh-laravel-creem-agent/health.svg)](https://phpackages.com/packages/romansh-laravel-creem-agent)
```

###  Alternatives

[spatie/laravel-health

Monitor the health of a Laravel application

85810.0M83](/packages/spatie-laravel-health)[yadahan/laravel-authentication-log

Laravel Authentication Log provides authentication logger and notification for Laravel.

416632.8k5](/packages/yadahan-laravel-authentication-log)[inspector-apm/inspector-laravel

Code Execution Monitoring, built for developers.

2332.0M2](/packages/inspector-apm-inspector-laravel)[laravel-notification-channels/discord

Laravel notification driver for Discord.

2371.3M11](/packages/laravel-notification-channels-discord)

PHPackages © 2026

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