README

AI content assistant for LaravelDesign. Adds Claude-powered Draft, Summarize, Improve, Translate, and Meta actions to Posts and Pages inside the Filament admin.

Install

composer require mrshanebarron/laraveldesign-pneuma

Register in your Filament panel alongside LaravelDesign:

use MrShaneBarron\LaravelDesign\Filament\LaravelDesignPlugin;
use MrShaneBarron\LaravelDesignPneuma\Filament\LaravelDesignPneumaPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            LaravelDesignPlugin::make(),
            LaravelDesignPneumaPlugin::make(),
        ]);
}

Supply your Anthropic API key:

ANTHROPIC_API_KEY=sk-ant-...

Publish the config to customize models, quotas, and which actions show up:

php artisan vendor:publish --tag=laraveldesign-pneuma-config

Attaching AI actions to forms

The plugin ships a PneumaActions facade you drop into your existing Filament form schemas. No panel hijacking — you opt in per field.

use MrShaneBarron\LaravelDesignPneuma\Filament\Actions\PneumaActions;

Forms\Components\TextInput::make('title')
    ->suffixAction(PneumaActions::draftFromTitle('content')),

Forms\Components\Textarea::make('content')
    ->hintActions([
        PneumaActions::summarize('content', 'excerpt'),
        PneumaActions::generateTags('content'),
        PneumaActions::metaDescription('content', 'meta_description'),
        PneumaActions::translate('content', 'translated_content'),
    ]),

What you get

• Draft with AI — writes a 600-900 word post from a title and optional outline
• Summarize with AI — 2-3 sentence summary of any field into any field
• Meta description with AI — SEO-ready 140-160 character meta from post content
• Suggest tags with AI — topical tags surfaced as a notification
• Translate with AI — preserves HTML markup to a target language

Models and cost

• Default model: claude-opus-4-7 (highest quality, used for Draft/Improve/Translate)
• Summarize and Meta use claude-sonnet-4-6 for throughput
• Tag generation uses claude-haiku-4-5 for lowest cost

Admin supplies the Anthropic API key; there's no SaaS relay, no middleman. Your key, your spend, your data.

Free vs paid tier

Free tier (default): 30 calls/hour per actor, ~50K input / 20K output tokens/hour.

Paid tier (planned): set PNEUMA_LICENSE_KEY in .env to remove quota limits and unlock site-content RAG, auto-moderation, and custom prompt templates.

License

MIT.