Bắt đầu

devkit dùng stack Docker Compose bạn đang có và chạy các thư mục Laravel bên cạnh nó. Mọi thứ dưới đây chạy được từ CLI, và app desktop cũng chạy đúng các lệnh này thay bạn.

1. Thêm stack

devkit stack add ~/Project/webpress/webpress-infra/webpress-super-app-local-development
devkit stack list

devkit đọc docker compose config và nhận ra các service theo image: database (MySQL hoặc MariaDB), Redis, Caddy, PHP-FPM, S3 và mail.

2. Park các site

devkit park ~/Project/webpress/sites   # mọi thư mục Laravel bên trong đều thành site
devkit link ~/work/one-off-site        # hoặc thêm từng thư mục
devkit site list

3. Chạy một site

devkit template get core-development   # template .env, tạo từ .env hiện tại
devkit site up core-development        # http://localhost:8100 kèm queue worker
devkit proc list core-development      # queue, schedule, vite…
devkit exec core-development -- php artisan about
devkit doctor core-development
devkit site down core-development

.env được render lại từ template mỗi lần chạy. Bản gốc được giữ ở ~/.config/devkit/backups/<site>/env.orig.

4. Làm song song với lane

devkit lane new core-development crm-fix   # worktree trên feat/crm-fix, database core_development_l1
devkit lane up core-development--crm-fix
devkit db snapshot core-development--crm-fix before-migrate
devkit db restore core-development--crm-fix before-migrate --yes
devkit lane rm core-development--crm-fix   # từ chối nếu còn thay đổi chưa commit hoặc chưa push

5. HTTPS với Caddy (tuỳ chọn)

devkit trust                                    # một lần: tin cậy CA local của mkcert (cần mật khẩu)
devkit site set core-development --engine caddy --php 8.3
devkit site up core-development                 # https://core-development.localhost
devkit xdebug on core-development

Cần một stack có service Caddy và PHP-FPM.

6. Kết nối AI agent

devkit mcp config claude-code      # in ra dòng cần dán
devkit mcp config cursor --write   # hoặc ghi thẳng vào cấu hình của dự án
devkit mcp audit                   # agent đã làm gì, mới nhất trước

Agent có đúng các thao tác của devkit dưới dạng tool. Tool xoá hay ghi đè cần "confirm": true, và mọi lệnh gọi được ghi vào ~/.config/devkit/audit.log trên máy bạn.

App desktop

macOS: devkit.app nằm trên menu bar. Chọn Open devkit… để mở cửa sổ quản lý với Sites, Lanes, Stacks, Templates, PHP, Settings và MCP.
Linux: devkit-gtk hiện biểu tượng trên tray (hoặc một cửa sổ nhỏ nếu không có tray) và cửa sổ quản lý các site cùng chi tiết của chúng.

devkit lưu gì, ở đâu

~/.config/devkit/: cấu hình, danh sách site, bản sao lưu .env, log, chứng chỉ và nhật ký audit MCP. Thư mục này theo biến XDG_CONFIG_HOME.
~/Library/Logs/devkit/devkit-app.log (macOS) và ~/.local/state/devkit/devkit-app.log (Linux): app đã chạy những lệnh gì.

Gỡ cài đặt

Thoát app, rồi xoá /Applications/devkit.app (macOS), hoặc xoá ~/.local/lib/devkit-app cùng các liên kết trong ~/.local/bin (Linux). Xoá ~/.config/devkit nếu muốn bỏ cả cấu hình của devkit. Site, stack và database của bạn giữ nguyên.

Còn thắc mắc? Xem trang Hỗ trợ.