Larvyn

The Laravel workbench: your Laravel apps, their dev services, terminals, data and AI coding agents in one native window. Built with Go + Wails 3 and React.

Persistent terminals with tabs and splits, and several AI agents working in parallel, each in its own git worktree, so you can compare their attempts and merge the winner. All of it aimed at Laravel.

Free and open source (MIT) for Windows, macOS and Linux. Website: larvyn.dev.

Install

macOS and Linux:

curl -fsSL https://larvyn.dev/install.sh | sh

Windows (PowerShell):

irm https://larvyn.dev/install.ps1 | iex

Running it again updates Larvyn; neither needs admin rights. Builds are also on the releases page. To uninstall, pass --uninstall to install.sh (sh -s -- --uninstall) or set $env:LARVYN_UNINSTALL = "1" before the PowerShell line.

What it does

View
Overview	Laravel/PHP versions, detected ecosystem (Filament, Livewire, Inertia, Horizon, Pest…), config summary, recent commits, and a Doctor that finds and fixes setup problems (missing vendor, .env, APP_KEY, pending migrations, storage link, debug in production).
Dev stack	One toggle each for artisan serve, Vite, queue (or Horizon), scheduler, Pail, Reverb, Octane. Output in the console drawer; processes are killed with their children. When Flock serves the app, it takes the place of artisan serve.
Agents	Launch Claude Code, Codex, OpenCode, Antigravity CLI, Cursor Agent, Aider or Pi. Pick several and the same prompt fans out, each agent on its own larvyn/<task> branch in a worktree with .env and SQLite copied (with Flock, each attempt also gets its own .test URL to try in the browser). Live status (working / waiting / needs attention), follow-ups, diff review, one-click merge or discard. Laravel playbooks (CRUD, tests, N+1, security review, upgrade…). Spec first mode runs the Elephant-Goldfish workflow (see below).
Terminals	Real PTYs (ConPTY on Windows) with tabs and splits that keep running across views and projects.
Artisan	Every command with a generated form for its arguments and options, favourites, and a generator studio for every make:*.
Routes	Searchable route table with method filters, middleware, open-controller-at-method, open in browser, copy route().
Models	Every Eloquent model with table, record count, casts, traits, relationships (both directions) and model:show attributes.
Database	Tables with row counts, paginated/searchable/sortable data grid, cell editor, structure (columns, indexes, foreign keys), SQL console with history, migrations status with migrate/rollback/fresh. Uses the app's own connection, so every driver Laravel supports works.
Tinker	Run PHP in the booted app: dump, JSON view, timing, memory and the query log.
Tests	Runs artisan test (optionally in parallel) and shows every Pest/PHPUnit test with its result, time, failure message and failing line. Re-run one test or all failing ones, open the failing line, or hand a failure to an agent.
Queues & Schedule	Worker status, pending jobs, failed jobs with retry/forget/flush, scheduled tasks with next run.
Logs	Live tail of storage/logs, level filters, parsed exceptions, stack frames that open in your editor, and Ask an agent to fix it. New errors raise a notification in any view.
Source control	Changes with diffs, commit, discard, branches, history and worktrees.
Dependencies	composer outdated for direct packages (safe vs major updates, one-click update) and composer audit security advisories with severity and CVE.
Environment	.env as a grouped form with masked secrets or raw text, keys missing from .env.example, automatic backups.

Ctrl K opens the command palette: navigate, start/stop services, run any artisan line (> migrate:fresh --seed), a shell line ($ npm run build), composer/npm scripts, the project's own commands, or hand a prompt to an agent or Tinker.

A team can commit a .larvyn/project.json with shared commands, extra dev-stack items, the plugins the project needs and the steps that prepare each new agent worktree (composer install, migrations…). See examples/project.

Flock (optional)

Flock is a free local PHP environment for Windows, macOS and Linux: PHP, Node, databases and *.test sites with trusted HTTPS, without Docker. Larvyn works without it; once it is installed, Larvyn uses it:

• Local site card in Overview, one click per step: set Flock up, start it, serve the app at <folder>.test, switch HTTPS, pick the PHP version (a missing one downloads with its progress shown) and open each worktree's URL. APP_URL follows the site when it was empty or localhost, with a backup of .env; the Doctor flags one that doesn't match.
• Laravel apps added to Larvyn are served by Flock right away (Settings → Flock turns this off).
• Agent worktrees are served by Flock at larvyn-<task>.<site>.test, set up by Flock itself (dependencies, .env, database), with a 🌐 button on each agent to compare attempts in the browser before merging.
• The dev stack drops artisan serve; Vite, the queue and the rest still run from Larvyn, since Flock doesn't run them.

Larvyn reads Flock's daemon API on its unix socket and makes changes with Flock's flk command, as a user would.

The larvyn command

Agents running in Larvyn can use it too (#107). Every terminal Larvyn opens has the larvyn command on its PATH, and it talks to the running app:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗