Tinkerwell 4 is out now! See what's new or buy now.
Tinkerwell background image
Tinkerwell Logo Tinkerwell
Hey! You are currently looking at the documentation for Tinkerwell 3. The latest version of the documentation is available here.


You can download Tinkerwell by logging in with your license key or via your Beyond Code account. The app is available for macOS (Intel+ARM), Windows and Linux.

Setting up PHP

Tinkerwell needs PHP locally on your machine to run the language server that powers the autocompletion feature. While you can run your applications within Docker or via SSH, the mighty autocompletion feature needs PHP locally. You can read more about the language server in the autocompletion section.

When you start Tinkerwell for the first time, the app tries to automatically detect the correct PHP version of your system. To check which version and binary Tinkerwell detected, you can look at the Tinkerwell settings screen. You can open the settings via the settings icon in the sidebar or by pressing CMD + , on Mac or Ctrl + , on other platforms.

Please make sure that Tinkerwell detected the correct PHP binary for your system, otherwise this can lead to strange errors or no output at all. The language server needs PHP 7.4+, your projects are supported with PHP 7.3+ and the default Laravel projects needs PHP 8.1+.

If you are on macOS and use PHP through homebrew, the correct location needs to be /usr/local/bin/php – except if you are running multiple PHP versions in parallel. If you run multiple versions of PHP, make sure to select the one that matches your needs.