v3.4.0

🤩 What's New

Better AI guidelines for Laravel Boost (~55% fewer tokens)

We audited the AI context Spin ships to Laravel Boost users against Anthropic's best practices:

• The always-loaded guideline uses ~55% fewer tokens on every prompt. Detailed content moved into the on-demand spin-laravel-development skill, so you only pay for it when you need it.
• Guidance no longer assumes you're using our template defaults. Agents are told to check your compose files for service names, versions, ports, and paths.
• Agents are warned that spin kill affects all containers on the machine and requires confirmation (which hangs automated sessions), and are pointed to spin stop or spin down instead.
• Each command now documents which official Docker Compose options it accepts (up, down, stop, build, logs, ps, pull, run, exec).

spin stop is now scoped to your project

Previously, spin stop stopped every container on your machine. It now wraps docker compose stop, so it only stops your project's containers and you can bring them back with spin up. You can also pass service names and any docker compose stop options, like spin stop php. If you want to stop everything on your machine, spin kill still does that.

🐛 Bug Fixes

• spin latest node now runs commands in your project directory. The volume mount and working directory didn't match, so node/npm commands silently ran in an empty directory.
• spin pull now forwards additional options to docker compose pull, as the docs always said it did. For example, spin pull --ignore-pull-failures now works.
• Fixed the spin latest no-arguments error message referring to spin new.

📚 Documentation

We audited all 26 command reference pages against the actual source code and fixed what didn't match:

• spin deploy: the SSH user defaults to the dedicated non-sudo deploy user created by spin provision, not your host username. The docs now explain why. Also fixed SPIN_BUILD_TAG (defaults to a timestamp), the 127.0.0.1 registry prefix, and removed a variable that was documented but never implemented.
• spin kill: documents its machine-wide scope and confirmation prompt.
• spin down and spin exec: removed an incorrect note claiming they don't work on Composer/npm installs, and documented which Docker Compose options they accept.
• spin init and spin new: documented the required template argument and all four official templates (laravel, laravel-pro, nuxt, skeleton), plus community username/repo templates.
• spin provision and spin maintain: added the missing -h|--host flag to usage examples.
• Smaller fixes to the base64, latest, and help pages.

🧼 Housekeeping

• Removed the outdated .cursorrules file (superseded by AGENTS.md).
• Contributor docs now point to bin/spin for the current tooling image versions.

Full Changelog: v3.3.0...v3.4.0