Setup e Uso — Tinkerwell + Laravel Boost

Guia prático para usar as duas ferramentas no projeto KOLOS.

1) Laravel Boost (MCP no Cursor)

Estado no projeto

• Dependência instalada: laravel/boost (dev).
• MCP configurado em .cursor/mcp.json para iniciar via Sail:
  • vendor/bin/sail artisan boost:mcp

Comandos úteis

• Ver comandos disponíveis:
  • php artisan list | grep boost:
• Atualizar guidelines/skills:
  • php artisan boost:update
• Validar stack detectado (Roster):
  • php artisan roster:scan .

Equivalente com Sail

• ./vendor/bin/sail artisan boost:update
• ./vendor/bin/sail artisan roster:scan .

Nota: boost:mcp é servidor JSON-RPC para o Cursor (não é comando para uso interativo no terminal).

2) Tinkerwell com WSL2 (SSH)

Pré-requisitos

• OpenSSH Server no WSL2.
• Serviço ssh ativo no WSL.
• Porta SSH aberta no firewall do Windows (se necessário).

Exemplo de Connection Manager

• Host: 127.0.0.1
• Port: 2222 (ou 22 se não tiver mudado)
• Username: seu usuário WSL (ex.: diogocs32)
• Remote Folder: /home/diogocs32/projetos/kolos
• PHP Binary Path: php
• Authentication: Password (mais simples) ou Private Key

Testes de conexão

• No WSL:
  • ssh -p 2222 diogocs32@127.0.0.1
• No PowerShell:
  • ssh "diogocs32@127.0.0.1" -p 2222

Se aparecer Connection refused, normalmente o ssh no WSL está parado:

• sudo service ssh start
• sudo service ssh status

3) Primeiro teste no Tinkerwell

app()->version();
config('database.default');
\App\Models\User::query()->count();

Saídas esperadas:

• versão do Laravel,
• driver atual de banco (pgsql, sqlite, etc.),
• contagem de utilizadores.

4) Driver local do KOLOS (.tinkerwell)

Este repositorio inclui um driver local:

• .tinkerwell/KolosLaravelTinkerwellDriver.php

O driver:

• confirma bootstrap Laravel no projeto (artisan + bootstrap/app.php);
• usa o bootstrap padrao do Laravel;
• expõe variaveis uteis no editor:
  • __env
  • __db
  • __appUrl
  • __actor (quando existir user autenticado + ActorContext)

Depois de qualquer alteracao no driver, reinicie o Tinkerwell.

5) Troubleshooting rapido

• Erro no Boost MCP (server_disabled)

  • conferir se o servidor laravel-boost está Enabled no Cursor.
  • reiniciar o Cursor após alterar .cursor/mcp.json.

• Autocompletion Service no Tinkerwell

  • garantir php.exe válido no Windows (Tinkerwell app roda no Windows).
  • confirmar no PowerShell: php -v e (Get-Command php).Source.

• WebSocket Reverb no browser

  • com Sail, reconstruir imagem após mudanças de supervisor:
    • ./vendor/bin/sail build laravel.test && ./vendor/bin/sail up -d