PHPackages                             agents-ready/laravel-installer - 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. [DevOps & Deployment](/categories/devops)
4. /
5. agents-ready/laravel-installer

ActiveLibrary[DevOps & Deployment](/categories/devops)

agents-ready/laravel-installer
==============================

Install Agents-Ready Laravel local-development tooling into Laravel applications.

v0.2.1(1mo ago)02↓50%MITPHPPHP ^8.3CI passing

Since Jun 28Pushed 1mo agoCompare

[ Source](https://github.com/agents-ready/laravel-installer)[ Packagist](https://packagist.org/packages/agents-ready/laravel-installer)[ Docs](https://github.com/agents-ready/laravel-installer)[ RSS](/packages/agents-ready-laravel-installer/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (3)Dependencies (7)Versions (4)Used By (0)

Agents-Ready Installer
======================

[](#agents-ready-installer)

Laravel Composer package that installs Agents-Ready local-development tooling into an application.

The installer generates project-local Docker wrappers, runtime Compose files, worktree helpers, and optional agent guidance. It is Docker-first and does not require Laravel Sail, host PHP, or host Composer after the generated tooling is installed.

Status
------

[](#status)

This repository is pre-release V1 work. The public command surface is intentionally small:

```
php artisan agents-ready:install
```

The installer writes files and local state only. It does not provision Docker resources during installation. The first `./local up` starts shared companions, provisions checkout databases/cache namespaces, starts runtime containers, and materializes runtime env files.

Requirements
------------

[](#requirements)

- Laravel 12 or 13 application.
- Docker with Docker Compose v2.
- A shared Traefik companion checkout.
- A shared services companion checkout.

Most projects keep the companion checkouts next to the application checkout:

```
../shared-traefik
../shared-services

```

The installer always requires explicit host paths for the app checkout and both companions. This keeps Docker-based installs unambiguous and makes the generated local config reproducible.

Quick Start
-----------

[](#quick-start)

Create a workspace and clone the shared companions:

```
mkdir -p ~/projects/agents-ready-real-test
cd ~/projects/agents-ready-real-test

git clone https://github.com/agents-ready/shared-traefik.git
git clone https://github.com/agents-ready/shared-services.git
```

Create a Laravel app with host Composer:

```
composer create-project laravel/laravel real-agent-app "^13.0"
cd real-agent-app
```

Install Agents-Ready:

```
composer require --dev agents-ready/laravel-installer:^0.2

php artisan agents-ready:install \
  --host-root="$(pwd)" \
  --traefik-home="$(cd ../shared-traefik && pwd)" \
  --services-home="$(cd ../shared-services && pwd)"
```

The install command is interactive by default. It will ask for project slug, runtime, database, and optional project conventions.

Start the stack:

```
./local up --wait
```

Verify:

```
./local status
./local artisan about
./local test
curl -kI https://real-agent-app.localhost
```

No Host Composer
----------------

[](#no-host-composer)

If the host has Docker but no PHP or Composer, use the Composer Docker image until `./local` exists.

Create the Laravel app:

```
mkdir -p ~/projects/agents-ready-real-test
cd ~/projects/agents-ready-real-test

git clone https://github.com/agents-ready/shared-traefik.git
git clone https://github.com/agents-ready/shared-services.git

docker run --rm -it \
  -u "$(id -u):$(id -g)" \
  -v "$PWD":/workspace \
  -w /workspace \
  composer:2.9.2 \
  create-project laravel/laravel real-agent-app "^13.0"

cd real-agent-app
```

Require the installer:

```
docker run --rm -it \
  -u "$(id -u):$(id -g)" \
  -v "$PWD":/app \
  -w /app \
  composer:2.9.2 \
  require --dev agents-ready/laravel-installer:^0.2
```

Run the installer:

```
docker run --rm -it \
  -u "$(id -u):$(id -g)" \
  -v "$PWD":/app \
  -w /app \
  --entrypoint php \
  composer:2.9.2 \
  artisan agents-ready:install \
    --host-root="$(pwd)" \
    --traefik-home="$(cd ../shared-traefik && pwd)" \
    --services-home="$(cd ../shared-services && pwd)"
```

After that, use the generated wrapper:

```
./local up --wait
./local artisan about
./local test
```

Existing App
------------

[](#existing-app)

Install the package as a development dependency in the Laravel application:

```
composer require --dev agents-ready/laravel-installer
```

Run the installer interactively. The three host paths are required arguments; project slug, runtime, database, and optional conventions can be selected from prompts.

```
php artisan agents-ready:install \
  --host-root="$(pwd)" \
  --traefik-home="$(cd ../shared-traefik && pwd)" \
  --services-home="$(cd ../shared-services && pwd)"
```

For non-interactive installs, add `--no-interaction` and pass any desired choices as options:

```
php artisan agents-ready:install \
  --host-root=/absolute/path/to/app \
  --traefik-home=/absolute/path/to/shared-traefik \
  --services-home=/absolute/path/to/shared-services \
  --runtime=frankenphp \
  --database=pgsql \
  --project-slug=real-app \
  --no-interaction
```

When installing from Docker, `--host-root` should be the real host checkout path. If the Laravel app still has the skeleton Composer name `laravel/laravel`, Agents-Ready derives the default project slug from this host path instead of the container mount path such as `/app`.

Options
-------

[](#options)

Runtime options:

```
php artisan agents-ready:install --runtime=frankenphp
php artisan agents-ready:install --runtime=nginx-php-fpm
```

Database options:

```
php artisan agents-ready:install --database=pgsql
php artisan agents-ready:install --database=mysql
```

Optional Horizon service:

```
php artisan agents-ready:install --horizon
```

Project identity and routing:

```
php artisan agents-ready:install --project-slug=real-app
php artisan agents-ready:install --route-domain=custom.localhost
```

`--project-slug` is the normal option for local resource identity. It is normalized, so `Real App` becomes `real-app`, and the default route domain becomes `.localhost`. `--route-domain` is an advanced full-domain override; it changes routing without changing the project slug.

Optional project conventions:

```
php artisan agents-ready:install --decision-notes
php artisan agents-ready:install --local-agent-notes
php artisan agents-ready:install --agent-skills
```

Existing project candidate mode:

```
php artisan agents-ready:install --existing-project-candidates
```

Candidate mode writes only `worktree.docker-compose.yml` for review/manual integration. It does not mutate existing `.env`, `.env.testing`, Compose, Sail, Docker, wrapper, or agent files.

Generated Workflow
------------------

[](#generated-workflow)

Common commands after installation:

```
./local up
./local down
./local status
./local artisan migrate
./local test
./local composer install
./local shell
./local assets dev
./local assets build
./local worktree list
./local worktree create
./local worktree remove
```

Vite is explicit: `./local up` does not start Vite. Use `./local assets dev` when needed.

`./local sail ...` is a compatibility alias for the generated wrapper. After `./local up`, direct `docker compose ...` commands also work for compatible workflows.

Identity And Env
----------------

[](#identity-and-env)

Agents-Ready identifies checkouts by `projectId + worktreeId` in `.agents-ready/worktree.json`.

For the main checkout, both `projectId` and `worktreeId` are the project slug. Worktree route hosts are derived from the main checkout route domain.

Runtime `.env` files contain app/runtime compatibility values such as `APP_URL`, `DB_*`, `REDIS_*`, `COMPOSE_PROJECT_NAME`, and `APP_SERVICE`. Agents-Ready identity is intentionally not written into `.env`.

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

[](#development)

This package is developed with Docker-first tooling:

```
make install
make format-test
make test
make analyse
```

Opt-in smoke checks are available:

```
make smoke-install
SMOKE_PROFILE=runtime SMOKE_RUNTIME=nginx-php-fpm SMOKE_DATABASE=mysql make smoke
```

Smoke workspaces default to `/tmp/opencode/agents-ready-installer-smoke` and clean recorded resources on successful runs.

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance90

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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

Every ~0 days

Total

3

Last Release

45d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2178ee709275fc28c8429dd999fdef3118c468bc703c1a5220fb761a50d374c1?d=identicon)[agents-ready](/maintainers/agents-ready)

---

Top Contributors

[![EdgarSedov](https://avatars.githubusercontent.com/u/16332716?v=4)](https://github.com/EdgarSedov "EdgarSedov (3 commits)")

---

Tags

laraveldockerfrankenphplocal-developmentworktreesagents-ready

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/agents-ready-laravel-installer/health.svg)

```
[![Health](https://phpackages.com/badges/agents-ready-laravel-installer/health.svg)](https://phpackages.com/packages/agents-ready-laravel-installer)
```

###  Alternatives

[laravel/sail

Docker files for running a basic Laravel application.

1.9k212.4M1.4k](/packages/laravel-sail)[laravel/ai

The official AI SDK for Laravel.

1.1k4.6M305](/packages/laravel-ai)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

79227.1M218](/packages/laravel-mcp)[propaganistas/laravel-disposable-email

Disposable email validator

6023.2M7](/packages/propaganistas-laravel-disposable-email)[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

731189.9k16](/packages/tallstackui-tallstackui)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)

PHPackages © 2026

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