How do I install integration-laravel?

Run `npx skills add https://github.com/PostHog/skills --skill integration-laravel` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does integration-laravel support?

integration-laravel works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is integration-laravel free to use?

Yes. integration-laravel is free to install and use. It is available from the open explainx.ai skill registry published by PostHog.

PostHogofficial

integration-laravel▌

Name: integration-laravel
Availability: InStock
Author: PostHog

PostHog/skills · updated Apr 10, 2026

$npx skills add https://github.com/PostHog/skills --skill integration-laravel

summary

### PostHog Laravel Integration

›Centralize analytics logic by creating a dedicated PostHogService class instead of scattering capture calls across controllers.
›Configure settings in config/posthog.php using environment variables and initialize the SDK once using PostHog::init().
›Identify users during authentication and maintain session correlation by passing distinct IDs via custom request headers.

skill.md

PostHog integration for Laravel

This skill helps you add PostHog analytics to Laravel applications.

Workflow

Follow these steps in order to complete the integration:

basic-integration-1.0-begin.md - PostHog Setup - Begin ← Start here
basic-integration-1.1-edit.md - PostHog Setup - Edit
basic-integration-1.2-revise.md - PostHog Setup - Revise
basic-integration-1.3-conclude.md - PostHog Setup - Conclusion

Reference files

references/EXAMPLE.md - Laravel example project code
references/laravel.md - Laravel - docs
references/identify-users.md - Identify users - docs
references/basic-integration-1.0-begin.md - PostHog setup - begin
references/basic-integration-1.1-edit.md - PostHog setup - edit
references/basic-integration-1.2-revise.md - PostHog setup - revise
references/basic-integration-1.3-conclude.md - PostHog setup - conclusion

The example project shows the target implementation pattern. Consult the documentation for API details.

Key principles

Environment variables: Always use environment variables for PostHog keys. Never hardcode them.
Minimal changes: Add PostHog code alongside existing integrations. Don't replace or restructure existing code.
Match the example: Your implementation should follow the example project's patterns as closely as possible.

Framework guidelines

Create a dedicated PostHogService class in app/Services/ - do NOT scatter PostHog::capture calls throughout controllers
Register PostHog configuration in config/posthog.php using env() for all settings (api_key, host, disabled)
Do NOT use Laravel's event system or observers for analytics - call capture explicitly where actions occur
Remember that source code is available in the vendor directory after composer install
posthog/posthog-php is the PHP SDK package name
Check composer.json for existing dependencies and autoload configuration before adding new files
The PHP SDK uses static methods (PostHog::capture, PostHog::identify) - initialize once with PostHog::init()
PHP SDK methods take associative arrays with 'distinctId', 'event', 'properties' keys - not positional arguments

Identifying users

Identify users during login and signup events. Refer to the example code and documentation for the correct identify pattern for this framework. If both frontend and backend code exist, pass the client-side session and distinct ID using X-POSTHOG-DISTINCT-ID and X-POSTHOG-SESSION-ID headers to maintain correlation.

Error tracking

Add PostHog error tracking to relevant files, particularly around critical user flows and API boundaries.