Skip to content

CLI reference

Commands that take a site use the site for the current folder when you leave it out.

List sites and what serves them

Terminal window
devkit sites [OPTIONS]
Argument Meaning
--json Print JSON

Show DevKit’s status

Terminal window
devkit status

Serve every folder inside PATH (default: current folder) as name.test

Terminal window
devkit park [PATH]
Argument Meaning
PATH Folder (default: the current folder)

Stop parking PATH (default: current folder)

Terminal window
devkit forget [PATH]
Argument Meaning
PATH Folder (default: the current folder)

Serve the current folder as NAME.test (default: the folder’s name)

Terminal window
devkit link [NAME]
Argument Meaning
NAME Site name (default: the folder’s name)

Remove a link

Terminal window
devkit unlink [SITE]
Argument Meaning
SITE Site (default: the site for the current folder)

Serve a site over HTTPS

Terminal window
devkit secure [SITE]
Argument Meaning
SITE Site (default: the site for the current folder)

Serve a site over plain HTTP

Terminal window
devkit unsecure [SITE]
Argument Meaning
SITE Site (default: the site for the current folder)

Set the default PHP version

Terminal window
devkit use <VERSION>

Pin a site to a PHP or Python version

Terminal window
devkit isolate [OPTIONS] <VERSION>
Argument Meaning
--site Site (default: the site for the current folder)

Go back to the default version

Terminal window
devkit unisolate [OPTIONS]
Argument Meaning
--site Site (default: the site for the current folder)

Set the command that starts a site’s dev server (“$PORT” is substituted)

Terminal window
devkit run <SITE> <COMMAND>
Argument Meaning
SITE Site name
COMMAND Command, e.g. npm run dev -- --port $PORT

Start a site

Terminal window
devkit start [SITE]
Argument Meaning
SITE Site (default: the site for the current folder)

Stop a site

Terminal window
devkit stop [SITE]
Argument Meaning
SITE Site (default: the site for the current folder)

Share a site on a public https address through Cloudflare

Terminal window
devkit share [SITE]
Argument Meaning
SITE Site (default: the site for the current folder)

Stop sharing a site

Terminal window
devkit unshare [SITE]
Argument Meaning
SITE Site (default: the site for the current folder)

Open a site in the browser

Terminal window
devkit open [SITE]
Argument Meaning
SITE Site (default: the site for the current folder)

Show recent requests (add –follow to watch)

Terminal window
devkit requests [OPTIONS] [SITE]
Argument Meaning
SITE Site (default: the site for the current folder)
-f, --follow Keep watching for new lines

Show a process’s log, e.g. site:shop, php:8.4 (add –follow to watch)

Terminal window
devkit logs [OPTIONS] [SOURCE]
Argument Meaning
SOURCE Log source (default: the site for the current folder)
-f, --follow Keep watching for new lines

Print the DevKit CA certificate (for tools that need it)

Terminal window
devkit ca

Run PHP for the current folder: the site’s version, with DevKit’s settings, e.g. devkit php artisan inspire

Terminal window
devkit php [ARGS]...
Argument Meaning
ARGS Arguments passed to PHP

Run Composer with the current folder’s PHP, e.g. devkit composer install

Terminal window
devkit composer [ARGS]...
Argument Meaning
ARGS Arguments passed to Composer

Serve the Model Context Protocol on stdio, for AI coding tools

Terminal window
devkit mcp

Manage a site’s background processes (queue workers, schedulers…)

Subcommands: list, add, start, stop, restart, remove.

List the current site’s processes and suggestions

Terminal window
devkit process list [OPTIONS]
Argument Meaning
--site Site (default: the site for the current folder)

Add a process and start it, e.g. devkit process add "php artisan queue:work"

Terminal window
devkit process add [OPTIONS] <COMMAND>
Argument Meaning
COMMAND Command to run in the site’s folder
--name Display name (default: the command)
--once Don’t start it with DevKit or restart it when it exits
--site Site (default: the site for the current folder)

Start a process

Terminal window
devkit process start [OPTIONS] <ID>
Argument Meaning
ID Process ID, from devkit process list
--site Site (default: the site for the current folder)

Stop a process

Terminal window
devkit process stop [OPTIONS] <ID>
Argument Meaning
ID Process ID, from devkit process list
--site Site (default: the site for the current folder)

Restart a process

Terminal window
devkit process restart [OPTIONS] <ID>
Argument Meaning
ID Process ID, from devkit process list
--site Site (default: the site for the current folder)

Stop and remove a process

Terminal window
devkit process remove [OPTIONS] <ID>
Argument Meaning
ID Process ID, from devkit process list
--site Site (default: the site for the current folder)