Packages

Sanvex is split into Composer packages. Install only what you need.

`sanvex/core`

The foundation. Provides:

composer require sanvex/core

Requires PHP 8.2+ and Laravel 12 or 13.

Artisan commands for setup and scaffolding. Registers only when the app runs in console.

composer require sanvex/cli

Command	Purpose
`sanvex:list`	List registered drivers and auth metadata
`sanvex:setup {driver}`	Store credentials (`--api-key`, `--bot-token`, owner options)
`sanvex:keygen`	Print a `SANVEX_KEK=...` line for `.env`
`sanvex:backfill {driver}`	Placeholder backfill hook (no driver logic yet)
`sanvex:make-driver {name}`	Scaffold a new driver package

Each driver is a separate Composer package with its own service provider:

Install only the drivers you use:

composer require sanvex/github sanvex/slack

Custom drivers are registered in config/sanvex.php:

'drivers' => [
    \App\Sanvex\AcmeDriver::class,
],

Exposes Sanvex to MCP-compatible clients (IDE agents, Claude Desktop, etc.).

composer require sanvex/mcp

Wraps Sanvex for Laravel AI agents. Provides SanvexAi with tool discovery and execution.

composer require sanvex/laravel-ai

Requires laravel/ai ^0.6.0. See Laravel AI integration.

Minimal (one driver):

composer require sanvex/core sanvex/cli sanvex/github
php artisan migrate
php artisan sanvex:setup github --api-key="ghp_..."

With agent tooling:

composer require sanvex/core sanvex/cli sanvex/github sanvex/mcp
# or
composer require sanvex/core sanvex/cli sanvex/github sanvex/laravel-ai