PHPackages                             fleetbase/ai - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. fleetbase/ai

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

fleetbase/ai
============

Fleetbase AI operations copilot and task automation module

0.0.1(yesterday)021↑2614.3%AGPL-3.0-or-laterPHPPHP ^8.0CI passing

Since Jul 1Pushed todayCompare

[ Source](https://github.com/fleetbase/ai)[ Packagist](https://packagist.org/packages/fleetbase/ai)[ RSS](/packages/fleetbase-ai/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (8)Versions (2)Used By (0)

Fleetbase AI
============

[](#fleetbase-ai)

Fleetbase AI is an operations copilot and task automation module for Fleetbase. It adds a global AI prompt to the Fleetbase console, records each AI turn as an auditable task, and gives Fleetbase extensions a capability framework for exposing safe AI-readable context and previewable actions.

This extension was scaffolded with the Fleetbase CLI and contains both the Ember engine and Laravel backend package for `fleetbase/ai`.

Current Status
--------------

[](#current-status)

This module is in active development. The current version includes:

- A global floating Fleetbase AI prompt opened from the header tray.
- Persistent chat sessions with history, continuation, ending, and soft-delete support.
- System-wide admin configuration for enabling Fleetbase AI and selecting a provider/model.
- OpenAI, Claude, and Local Preview provider support.
- Durable `ai_tasks`, `ai_task_steps`, and `ai_sessions` recording.
- Markdown response rendering, including lists, links, inline code, and simple tables.
- Attachment upload references for AI turns.
- A capability registry for modules to register read/context capabilities and preview/apply actions.
- Fleet-Ops pilot capabilities, including order context/insights and a compact create-order preview flow.

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

[](#installation)

Install this extension like any Fleetbase extension package:

```
flb install fleetbase/ai --path /path/to/fleetbase
```

The `--path` value should point to the Fleetbase instance directory containing both `console/` and `api/`.

For local development inside a Fleetbase workspace, ensure the console workspace includes `@fleetbase/ai-engine`, then rebuild the console assets after frontend changes.

Admin Configuration
-------------------

[](#admin-configuration)

Fleetbase AI is configured system-wide by admins. Provider keys are not stored per company.

In the console admin settings:

1. Open **AI &gt; Provider Settings**.
2. Enable Fleetbase AI.
3. Select a provider.
4. Select the default model from the backend-supported model list.
5. Enter provider credentials for the selected provider.
6. Save and test the provider.

Supported providers:

- **Local Preview**: local non-network placeholder provider for development and UI testing.
- **OpenAI**: Responses API integration.
- **Claude**: Anthropic Messages API integration.

Base URLs are treated as advanced settings and default to the canonical provider API endpoints.

Console Experience
------------------

[](#console-experience)

When enabled, Fleetbase AI registers a compact magic-wand tray button in the Fleetbase console header. The same prompt can be opened globally with the configured keyboard shortcut.

The prompt supports:

- Persistent sessions instead of throwaway one-off prompts.
- Multi-line expanding input.
- User and AI turns in the transcript.
- Session history with delete controls.
- Uploaded file references for future capability-specific parsing.
- Action preview cards, such as Fleet-Ops create-order previews.

Closing the prompt only hides it. A chat session continues until the user starts a new chat, ends the current chat, or deletes the session from history.

Capability Framework
--------------------

[](#capability-framework)

Fleetbase AI does not give providers arbitrary database access. Modules expose AI functionality explicitly by registering capabilities.

Capabilities can provide:

- Read/context data for prompts.
- Preview-only actions.
- Confirmed apply actions.
- Permission metadata.
- Module-specific UI preview components.

Fleet-Ops is the first pilot module using this framework. Its initial capabilities are intentionally conservative: read/report context and preview-confirm-apply actions rather than silent mutations.

Fleet-Ops Pilot
---------------

[](#fleet-ops-pilot)

The Fleet-Ops pilot currently focuses on useful operational workflows:

- Answering questions about orders and operational resources.
- Producing bounded order insights and simple reports.
- Returning docs/help context for Fleet-Ops workflows.
- Previewing Fleet-Ops order creation from natural-language prompts.

Create-order actions use a dedicated compact preview component designed for the AI prompt. The preview can show pickup/dropoff details, a small route preview, driver/vehicle assignment fields, POD and dispatch toggles, notes, and explicit create/cancel controls.

Orders are not created until the user confirms the preview.

Development Checks
------------------

[](#development-checks)

Frontend checks:

```
./node_modules/.bin/eslint addon/services/ai.js addon/components/ai-prompt.js
./node_modules/.bin/ember-template-lint addon/components/ai-prompt.hbs
./node_modules/.bin/stylelint addon/styles/ai-engine.css
```

Backend checks:

```
php -l server/src/routes.php
php -l server/src/Http/Controllers/Internal/AiSessionController.php
```

The local template-lint configuration may print `Invalid rule configuration found: no-down-event-binding` while still exiting successfully.

Notes
-----

[](#notes)

- Billing and SaaS metering are intentionally outside this module.
- Token usage is retained as provider telemetry.
- Session deletion is a soft delete; task and step records are retained for auditability.
- User-facing copy should use `Fleet-Ops` for the operations module name.

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance100

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 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

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9350b92834554a15fb0fff7c7c73750c86a5edd5038e4f0006f8b888a9379b57?d=identicon)[fleetbase](/maintainers/fleetbase)

---

Top Contributors

[![roncodes](https://avatars.githubusercontent.com/u/816371?v=4)](https://github.com/roncodes "roncodes (13 commits)")

---

Tags

automationaicopilotoperationsfleetbasefleetbase-extension

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/fleetbase-ai/health.svg)

```
[![Health](https://phpackages.com/badges/fleetbase-ai/health.svg)](https://phpackages.com/packages/fleetbase-ai)
```

###  Alternatives

[fleetbase/fleetops-api

Fleet &amp; Transport Management Extension for Fleetbase

1731.5k7](/packages/fleetbase-fleetops-api)[anthropic-ai/sdk

Anthropic PHP SDK

163583.3k15](/packages/anthropic-ai-sdk)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35789.4k2](/packages/telnyx-telnyx-php)[cognesy/instructor-php

The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control

318123.0k1](/packages/cognesy-instructor-php)[stimmt/craft-mcp

MCP (Model Context Protocol) server for Craft CMS

261.9k](/packages/stimmt-craft-mcp)[mohamed-ashraf-elsaed/claude-agent-sdk-laravel

Anthropic Claude Agent SDK for PHP &amp; Laravel — build AI agents with tool use, sandboxing, MCP servers, subagents, hooks, and structured output via the Claude Code CLI

171.1k](/packages/mohamed-ashraf-elsaed-claude-agent-sdk-laravel)

PHPackages © 2026

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