PHPackages                             springloadedco/turbo - 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. springloadedco/turbo

ActiveLibrary

springloadedco/turbo
====================

Springloaded's Laravel AI development toolkit.

330↓100%[2 PRs](https://github.com/springloadedco/turbo/pulls)PythonCI passing

Since Feb 3Pushed 1mo agoCompare

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

READMEChangelogDependenciesVersions (16)Used By (0)

[![Turbo](turbo.png)](turbo.png)

What is Turbo?
--------------

[](#what-is-turbo)

Turbo is Springloaded's opinionated toolkit for AI-assisted Laravel development. It combines open source [Superpowers](https://github.com/obra/superpowers) — brainstorming, plan creation, and plan execution — with Springloaded's own standards, skills, and tooling to create a consistent, high-quality environment for building applications.

### Superpowers Workflow

[](#superpowers-workflow)

Turbo includes the [Superpowers](https://github.com/obra/superpowers) plugin, which provides a structured development workflow through slash commands:

```
/brainstorming ──> /writing-plans ──> /executing-plans ──> Review
                        ^                                    │
                        └────────── needs changes ───────────┘

```

CommandWhat it does`/brainstorming`Explore the idea — ask questions, consider approaches, produce a design`/writing-plans`Turn the design into a step-by-step implementation plan`/executing-plans`Execute the plan with review checkpoints between stepsOther superpowers activate automatically when relevant — test-driven development before writing code, systematic debugging when something breaks, verification before claiming work is done.

### Skills

[](#skills)

**Skills** encode how Springloaded builds Laravel apps — controllers, actions, testing, validation, Inertia, GitHub workflows, and more. They work with any agent that supports skills (Claude, Cursor, Codex, GitHub Copilot) via [`npx skills`](https://skills.sh), so the whole team builds the same way regardless of which agent they use.

### Docker Sandbox

[](#docker-sandbox)

**Docker Sandbox** lets you run Claude in an isolated environment with your project workspace mounted, so agents can work freely without touching your local machine. Build the sandbox image once, then launch interactive sessions or fire off one-shot prompts from the command line.

### Feedback Loops

[](#feedback-loops)

**Feedback Loops** wire your project's verification commands (tests, linting, static analysis) directly into skill templates, so agents check their own work as they go.

### Prerequisites

[](#prerequisites)

- PHP 8.4+
- Laravel 11 or 12
- Node.js / npm (required for `npx skills`)
- Docker Desktop 4.61+ (required for sandbox commands)

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

[](#installation)

Turbo is currently pre-release. Until a stable version is tagged, require it with `@dev`:

```
composer require springloadedco/turbo:@dev --dev
```

### From a Local Clone

[](#from-a-local-clone)

If you have Turbo cloned locally and want to symlink it instead, point Composer at your local clone:

```
composer config repositories.turbo path /path/to/turbo
```

You'll need to disable symlinking if you plan on using Laravel Boost. If you install without the symlink, you'll need to re-run composer require any time you want to pull changes.

```
composer config repositories.turbo.options.symlink false
```

Then require the package:

```
composer require springloadedco/turbo:@dev --dev
```

Composer will automatically symlink the local directory, so changes are reflected immediately without re-installing.

Getting Started
---------------

[](#getting-started)

Run the install command to configure skills, set up a GitHub token, and build the Docker sandbox:

```
php artisan turbo:install
```

Then launch an interactive Claude session in the sandbox:

```
php artisan turbo:claude
```

On the first run, you'll be prompted to authenticate with Claude. This only needs to be done once per sandbox.

To re-publish Turbo's skills after a package update:

```
php artisan turbo:skills
```

Skills
------

[](#skills-1)

Turbo publishes the following skills to your project:

SkillDescription`laravel-actions`Business logic encapsulation patterns`laravel-controllers`Invokable controller patterns with Inertia`laravel-testing`Pest/PHPUnit testing best practices`laravel-validation`Form Request validation patterns`laravel-inertia`TypeScript page component patterns`github-issue`Create atomic GitHub issues for agent execution`github-labels`Apply consistent labels to GitHub issues`github-milestone`Create well-structured GitHub milestones`github-pr-comment`Add progress comments to PRs during agent executionConfiguration
-------------

[](#configuration)

Publish the config file to customize Turbo's behavior:

```
php artisan vendor:publish --tag=turbo-config
```

This creates `config/turbo.php` where you can configure feedback loops — the verification commands injected into skill templates at publish time:

```
'feedback_loops' => [
    'composer lint',
    'composer test',
    'composer analyse',
    'npm run lint',
    'npm run types',
    'npm run build',
    'npm run test',
],
```

Remove or add commands to match your project's toolchain. These are rendered into skill templates via the `{{ $feedback_loops }}` and `{{ $feedback_loops_checklist }}` placeholders.

The config also includes Docker sandbox settings:

```
'docker' => [
    'image'      => env('TURBO_DOCKER_IMAGE', 'turbo'),
    'dockerfile' => env('TURBO_DOCKER_DOCKERFILE'),
    'workspace'  => env('TURBO_DOCKER_WORKSPACE', base_path()),
],
```

KeyDescriptionDefault`image`Docker image tag used for build and run`turbo``dockerfile`Path to a custom Dockerfile (falls back to the one shipped with Turbo)`null``workspace`Local directory mounted into the sandbox`base_path()`Commands
--------

[](#commands)

CommandDescription`turbo:install`Set up Turbo for your project (see [Getting Started](#getting-started))`turbo:skills`Re-publish Turbo skills after a package update`turbo:build`Build the Docker sandbox image`turbo:claude`Start an interactive Claude session in the Docker sandbox`turbo:prompt {prompt}`Run Claude with a one-off prompt in the Docker sandbox### Docker Sandbox

[](#docker-sandbox-1)

Turbo ships a Dockerfile based on `docker/sandbox-templates:claude-code` with PHP 8.4, common extensions, and Composer pre-installed.

**Build the image:**

```
php artisan turbo:build
```

**Start an interactive Claude session:**

```
php artisan turbo:claude
```

This opens an interactive Claude session inside the sandbox with your project workspace mounted.

**Run a one-off prompt:**

```
php artisan turbo:prompt "Write tests for the UserController"
```

Sends the prompt to Claude inside the sandbox and streams the output back to your terminal.

Development
-----------

[](#development)

When working on Turbo itself, use `bin/turbo` to run commands via Orchestra Testbench:

```
bin/turbo install    # turbo:install
bin/turbo build      # turbo:build
bin/turbo claude     # turbo:claude
bin/turbo prompt "…" # turbo:prompt
```

Optionally, install [direnv](https://direnv.net) to drop the `bin/` prefix and just use `turbo `:

```
brew install direnv
```

Add the hook to your shell (`~/.zshrc`):

```
eval "$(direnv hook zsh)"
```

Then allow the project's `.envrc`:

```
direnv allow
```

After that, `turbo claude`, `turbo build`, etc. work directly whenever you're in the project directory.

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Jeff Sagal](https://github.com/sagalbot)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance63

Regular maintenance activity

Popularity13

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity21

Early-stage or recently created project

 Bus Factor1

Top contributor holds 92.2% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/0dafcec0352ac1a4de72f679bf2c72752d967bd388ec4e9c186142738993b945?d=identicon)[owenconti](/maintainers/owenconti)

![](https://www.gravatar.com/avatar/4ae5691168bf4514c10cf8ec89671d4712af795b62a445482153dd68b2651d36?d=identicon)[sagalbot](/maintainers/sagalbot)

---

Top Contributors

[![sagalbot](https://avatars.githubusercontent.com/u/692538?v=4)](https://github.com/sagalbot "sagalbot (119 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (9 commits)")[![raven-pierce](https://avatars.githubusercontent.com/u/108248559?v=4)](https://github.com/raven-pierce "raven-pierce (1 commits)")

### Embed Badge

![Health badge](/badges/springloadedco-turbo/health.svg)

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

PHPackages © 2026

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