Early preview

Runlet

The PHP scratchpad that feels at home on your Mac.

Run snippets against a bundled Laravel sandbox, your local projects, Docker containers, or servers over SSH. See the result, the SQL queries it ran, the mail it sent, and the logs it wrote. Then query the database, Redis, or MongoDB in a tab of its own.

Free & open source · MIT License

macOS 15 or later · Apple silicon & Intel

The Runlet window. Vertical tabs on the left list nine tabs: the Laravel sandbox; five on a local project, among them an SQL, a Redis, and a MongoDB tab; a Docker container; and two SSH servers, one marked production. The editor shows a Laravel snippet that creates users with a factory, with inlay hints for parameter names; the output pane shows a dump and the result as a table of names, handles, and emails.

Runlet’s own PHP

No PHP? No problem.

Runlet runs PHP on a Mac with nothing installed: no Herd, no Homebrew, no Docker. One click downloads its own PHP 8.5.8, and the Laravel sandbox and your projects run on it.

Four numbered steps in Runlet on a Mac without PHP or Docker. 1, No PHP, no Docker: a banner above the editor says no PHP was found and offers a Download PHP 8.5.8 button. 2, One click, about 26 MB: the same banner shows the download at 52 percent. 3, Checked and installed: Settings, PHP lists PHP 8.5.8 from Runlet as the automatic choice and says PHP 8.5.8 installed. 4, Runs right away: a Laravel sandbox tab runs a snippet that returns PHP 8.5.8, Runlet's build 8.5.8-r3, a price formatted in euros with intl, the SQLite version, mongodb and sodium loaded, and 55 extensions.
  1. No PHP found

    A banner above the sandbox or a local project offers Runlet’s PHP. So does Settings ▸ PHP.

  2. One click

    A self-contained PHP 8.5.8 for your Mac’s CPU, about 26 MB, from Runlet’s GitHub releases. Nothing downloads until you click.

  3. Checked, then installed

    It must match the SHA‑256 pinned in Runlet and run before it’s installed in Application Support.

  4. Ready to run

    The sandbox, local projects, and database connections from this Mac use it right away, with intl, SQLite, MySQL, PostgreSQL, Redis, MongoDB, gd, and sodium.

Your PHP always comes first. Herd, Homebrew, or the php on your PATH win, and Runlet’s PHP is the fallback. Choose it per project or as the default, or remove it, in Settings ▸ PHP.

Run anywhere

One editor. Every place your PHP lives.

Every tab has a target. Switch it from the toolbar or with ⌘P, press Run, and the output, dumps, errors, and Stop behave the same everywhere.

Laravel sandbox

A fresh Laravel app with SQLite, bundled with Runlet. Runs on your PHP, on Runlet’s own when you have none, or in a php:8.4-cli container.

Local projects

Open any folder. Laravel, Symfony, WordPress, and Composer projects boot automatically, on PHP 7.4 or newer.

Docker containers

Pick a running container or Compose service. Runlet finds it again after it’s recreated, and never picks a different one silently.

SSH servers

Hosts from ~/.ssh/config, jump hosts included. ssh-agent and 1Password work as in Terminal; password and 2FA logins stay connected until you disconnect.

A tab on the staging SSH server, app.example.com. The snippet returns the server's PHP version, operating system, release folder, memory limit, and extension count; the output shows PHP 8.4 on Linux in a releases folder, and the status bar says Connected.
A snippet on a staging server: the server’s own PHP, in the app’s folder. Your code goes over stdin and is never written on the server.

Production asks first.

Mark a target as staging or production. Production gets a red badge on its tab, toolbar, and status bar, and every run shows you what will run, and where, before it does.

  • ⌘↩ runs; ↩ and Esc cancel, so a reflexive Return never runs code on production.
  • Project commands on production confirm every time.
  • Runlet stores no SSH passwords or keys. It uses your system ssh.
A confirmation sheet titled “Run this code on production?” over a tab on the production SSH server. It shows the target, shop.example.com, the code that will run, a “Don't ask again for 10 minutes for this target” checkbox, and Cancel and Run on Production buttons.

Run inspector

See what your code actually did.

Results arrive as structured, expandable values. Next to them, Runlet shows the SQL queries the run made, the mail it sent, and the log messages it wrote.

The Queries section after a run on a local Laravel project: 14 queries with their times, connection, and the snippet line that ran each one. Hints at the top flag a statement run 3 times identically and two N+1 patterns run 6 times.
Queries with their time, bindings, and the line that ran them. Repeated statements are flagged, and N+1 patterns get an eager-loading hint.

Mail you can read, without sending it.

Mailables, notifications, views, and HTML responses render in a locked-down preview: no JavaScript, no navigation, and no remote loads unless you allow them. Turn on mail interception and Laravel builds each message without sending it.

The Mail section: one message marked Intercepted, “Your order AC-10250 is on its way”, with its sender, recipient, mailable class, and a rendered HTML preview of the order email.

Queries everywhere

Laravel, Eloquent without Laravel, Symfony’s Doctrine, and WordPress, with no setup. Standalone DBAL or plain PDO take one line in a driver.

Structured, Plain, or Raw

Expandable value trees, a sortable table for rows and collections, a CLI-style transcript, or the exact bytes.

Take it with you

Copy values as JSON, PHP, or Markdown, export tables as CSV, and save the whole output to a file.

Databases

Query the database your app already uses.

An SQL tab runs statements on the application’s own connection, so there are no credentials to enter. Save connections for any other database, and open Redis and MongoDB in tabs of their own.

An SQL tab on a local Laravel project, on the application’s own SQLite connection. The statement joins orders and users and has two placeholders, :status and :since, whose typed values sit in the parameters drawer under the editor. Below it, the result: five customers with their number of orders and their revenue. On the right, the Database pane lists the tables, with orders expanded to its columns, keys, and unique index.
Placeholders get typed values in a drawer, bound by the driver. Explain shows the plan without running the statement, Load Next reads past the first 1,000 rows, and a whole query exports to CSV.

Redis and MongoDB, too.

A Redis tab runs commands one per line, next to a key browser and a server panel. A MongoDB tab runs a query written as JSON, with a collection explorer and Load More.

  • The builders (⌥⌘B) put a Redis command or a MongoDB query together in a form and write it into the editor. They never run anything.
  • Dangerous Redis commands and destructive MongoDB queries always ask first, and production asks before every run.
A MongoDB tab on a saved connection to a shop_demo database, below horizontal tabs that include SQL, Redis, and MongoDB tabs. Next to the JSON query, the Query Builder shows the same find as a form: a filter on a rating of at least 4 and verified reviews, five projected fields, a descending sort on posted_at, and a limit of 20. The output shows 20 reviews as a table of product, rating, title, and date.

Saved connections

MySQL and MariaDB, PostgreSQL, SQLite, SQL Server, and custom DSNs, with passwords in the Keychain. Make one read-only, or connect through an SSH profile’s tunnel or from this Mac.

The Database pane

The schema explorer lists tables, columns, keys, and indexes. Browse Table pages through a table on the server, Show Relations draws its foreign keys, and the Server section shows sizes and sessions.

Stop means stop

Stop cancels a running statement on the database server. The Connection Manager lists every connection, tunnel, and run Runlet has open.

Editor & completion

An editor that knows your project.

Runlet indexes your project with PHPantom, so models, relations, and columns complete as you type, with hover, signature help, diagnostics, and code navigation. It works for Docker and SSH targets too, from their checkout on your Mac.

The completion list under “$order->” in a Laravel project, listing the Order model's columns and relations with their types: created_at Carbon, customer User, customer_id int, items Collection of OrderItem, number string, and more.
Columns from migrations, relations, and their types, straight from the project.

Everything is a keystroke away.

⌘P opens anything: targets, snippets, recent files, and your run history. ⇧⌘P finds any command. Every shortcut can be changed in Settings.

  • Horizontal tabs, or vertical tabs as cards that show each target, its PHP version, and its framework. Pin the tabs you always keep open.
  • Several windows, and workspace files that bring a set of tabs back.
  • History per project, personal snippets, and project snippets in .runlet/snippets.
The Open Anything palette over the editor, listing the Laravel sandbox, a local project, a Docker profile, two SSH servers, and four saved snippets.

Go to Definition

F12 or ⌘-click. Project files open in your editor at the line; vendor code opens in a read-only peek beside the snippet.

References and code actions

⇧F12 lists every use. ⌥↩ offers fixes such as Import class, applied to the tab as one undo step.

Inlay hints and folding

Parameter names and inferred types right in the code, and folds for functions, arrays, and comments.

Drivers & commands

Speaks Laravel. And your app.

Laravel, Lumen, Laravel Zero, Symfony, WordPress, and Composer projects are detected and booted for you. For anything else, a small driver in your project’s .runlet folder teaches Runlet how to boot it.

The Commands pane lists the project's Artisan commands with descriptions and run buttons, below the driver's variables. The terminal panel at the bottom shows php artisan test passing 6 tests.
The Commands pane lists Artisan or console commands, Composer scripts, and your own tools. Run one and it opens in the integrated terminal.

A driver is one PHP class.

Boot your app, hand snippets the variables they need, add commands to the Commands pane, declare tools that run on your Mac, and add sections of your own to the run inspector.

Read the driver guide

// .runlet/ShopDriver.php
use Runlet\Drivers\LaravelDriver;

class ShopDriver extends LaravelDriver
{
    public function variables(): array
    {
        return parent::variables() + [
            'cart' => $this->app->make(Cart::class),
        ];
    }

    public function hostCommands(): array
    {
        return [
            'up' => 'docker compose up -d',
        ];
    }
}

And plenty more.

  • Log viewer

    View ▸ Logs (⌘L) parses Laravel, Symfony, and WordPress logs and follows them as they’re written. Containers and servers only when you click Follow.

  • Dry Run

    Run a PHP tab in database transactions that Runlet always rolls back. On MySQL and MariaDB, statements that would commit are refused.

  • Connection Manager

    Every SSH connection, tunnel, database session, and run Runlet has open, in one window (⇧⌘C), each with Close.

  • Errors with their source

    Error cards show the lines around the one that failed, and their stack frames open to the code.

  • Integrated terminal

    Your login shell, in the project’s folder. Commands wait until the shell is ready.

  • The runlet command

    runlet . opens the current folder; runlet file.php opens a file.

  • History & snippets

    Every run, per project or for all of them, plus personal snippets and the project snippets your team commits in .runlet/snippets.

  • Follows your files

    Tabs opened from files reload when another app changes them, and ask when you have edits.

  • Open in your editor

    File paths in output open at their line in PhpStorm, VS Code, Cursor, Zed, Sublime Text, and more.

  • Updates built in

    Runlet ▸ Check for Updates… checks the new version’s signature, installs it, and relaunches. Choose the Stable or Beta channel.

  • Tour & What’s New

    A short guided tour on first launch, and What’s New after an update, with Show Me tours of the new features.

  • Private by design

    No account, analytics, or crash reports. The update check is one request to GitHub, at launch and once a day, with nothing about you or your Mac, and you can turn it off.

Open source

Free. Open source. MIT.

Runlet is free, and the whole app is on GitHub under the MIT License: read the code, file an issue, send a pull request, or build your own copy.

Built with Swift, SwiftUI, and AppKit. Runlet bundles SwiftTerm (MIT), Sparkle (MIT), PHPantom, Mago (MIT or Apache-2.0), nikic/php-parser (BSD-3-Clause), and a Laravel sandbox (MIT); their notices ship inside the app.

Install

Up and running in a minute.

  1. Download

    Get the .dmg or .zip from the latest release and move Runlet to Applications. One universal app runs on Apple silicon and Intel.

  2. Open it the first time

    Runlet is an early release, ad-hoc signed and not yet notarized, so macOS blocks the first launch. Open Runlet once; macOS says it can’t verify it. Then go to System Settings ▸ Privacy & Security and click Open Anyway next to the message about Runlet, then confirm. Or run this in Terminal:

    /usr/bin/xattr -dr com.apple.quarantine /Applications/Runlet.app

    You do this once: updates installed from Runlet don’t need it.

  3. Run something

    The Laravel sandbox is ready in the first tab. Press ⌘R; if your Mac has no PHP, click Download PHP 8.5.8 in the banner above it first. Open a project with ⇧⌘O, or from Terminal with the runlet command (Runlet ▸ Install Command-Line Tool…).

Requirements

  • macOS 15 or later, on Apple silicon or Intel.
  • For the sandbox: nothing more. It uses PHP 8.3 or later on your Mac, Runlet’s own PHP (one click to download), or Docker (Docker Desktop or OrbStack).
  • For your projects: PHP 7.4 or later, on your Mac, in the container, or on the server.
  • For saved connections that open from this Mac: a PHP with their driver. Runlet’s own PHP has MySQL, PostgreSQL, SQLite, and MongoDB, and Redis needs none; SQL Server needs a PHP with pdo_sqlsrv or pdo_dblib.
  • Docker and SSH are optional; use them only for those targets.

Questions

Is Runlet really free?

Yes. There is no paid version, no trial, and no account. Runlet is open source under the MIT License.

Is it ready for daily use?

Runlet is an early preview, built quickly with AI assistance. Expect rough edges. If something breaks or feels off, please open an issue on GitHub; it helps a lot.

Why does macOS say it can’t check Runlet for malicious software?

Runlet is an early release, ad-hoc signed and not yet notarized by Apple, so macOS blocks the first launch. Open Runlet once; macOS says it can’t verify it. Then go to System Settings ▸ Privacy & Security and click Open Anyway next to the message about Runlet, then confirm. Or remove the quarantine flag in Terminal with /usr/bin/xattr -dr com.apple.quarantine /Applications/Runlet.app. You only do this once: updates installed from Runlet remove the flag themselves. If you prefer, build it from source.

Does Runlet upload my code anywhere?

No. Code runs on the target you pick: your Mac, a Docker container, or a server you connect to with your own ssh. Your code reaches PHP over stdin and is never written to disk. On a server, the only things kept are Runlet’s runner and the app’s compiled PHP, in a private cache that you can turn off. Runlet has no telemetry and stores no SSH keys or SSH passwords. Passwords of saved database connections go only into your Mac’s Keychain.

Will it run code without asking?

No. Your snippets run when you press Run; opening a project, switching tabs, or restoring a session doesn’t run them, and opening an SQL, Redis, or MongoDB tab or choosing its connection doesn’t connect or run anything. The Commands pane boots a project to list its commands only while the pane is open, and never on its own for SSH or production targets. Production targets confirm every run and every project command.

Do I need PHP installed?

No. If your Mac has no PHP, Runlet offers to download its own: a self-contained PHP 8.5.8, about 26 MB, checked against a SHA-256 pinned in the app and kept in Application Support. The sandbox and your local projects run on it, without Herd, Homebrew, or Docker. If you have PHP installed, Runlet uses yours first.

Which PHP versions does it support?

Your projects can use PHP 7.4 or newer, locally, in Docker, or over SSH. The bundled Laravel sandbox needs PHP 8.3 or newer; without it on your Mac, Runlet offers to download its own PHP 8.5.8, or runs the sandbox in a php:8.4-cli container.

Can I use it with frameworks other than Laravel?

Yes. Symfony, WordPress, Lumen, Laravel Zero, and plain Composer projects work out of the box, and a project driver in .runlet/ can boot anything else. See the driver guide.

How do I update?

Choose Runlet ▸ Check for Updates…, then Install and Relaunch. Runlet also checks by itself at launch and once a day, and installs nothing until you choose. It checks the update’s signature first, removes the quarantine flag so macOS doesn’t ask again, and puts back the version you had if the new one doesn’t start. In Settings ▸ General ▸ Updates, choose the Stable or Beta channel, or turn the automatic checks off.

Runlet 0.3.0 and older (and 0.4.0 betas 1 to 6) can’t update themselves: download the newest release and replace the app once. Your tabs, snippets, history, and targets stay in ~/Library/Application Support/Runlet.