# laravel/envoy

Elegant SSH tasks for PHP.

Repository: https://github.com/laravel/envoy
Canonical: https://ross.abutalabs.com/products/laravel-envoy
Homepage: https://laravel.com/docs/envoy
Language: PHP
License: MIT
License Family: permissive
Topics: laravel, ssh
Last push: 2026-08-20T12:51:23+00:00

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 77, longevity 100
- inputs: {"age_days": 4589, "days_push": 13, "days_rel": 154, "gap_med": 10.5, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1614, forks 179 (observed 2026-08-28T04:05:11.399173+00:00)

## What it is
Laravel Envoy is a PHP-based CLI tool for defining and running common tasks on remote servers over SSH using a clean Blade-style syntax. It supports multiple servers, setup variables, stories, hooks, confirmation prompts, and notifications to Slack, Discord, Telegram, and Microsoft Teams.

## Use cases
- run deployment tasks on remote servers over ssh
- restart queue workers on multiple servers from one command
- define repeatable remote shell tasks with blade syntax
- send slack or telegram notifications when deploy tasks finish
- run artisan commands on remote laravel servers

## When to choose
- you want a lightweight, declarative way to run ssh tasks for php/laravel deployments
- you prefer blade-style task definitions over raw shell scripts or ansible playbooks
- you need multi-server task execution with hooks and chat notifications

## When to avoid
- you need full configuration management or idempotent provisioning (use ansible or terraform)
- you develop on windows without wsl2, since envoy only supports mac and linux natively
- your tasks are not ssh/remote-oriented

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, deployment, ssh, workflow-automation
- domain: developer-tools
- platform: cli, php
- tags: ssh-tasks, remote-execution, laravel, blade-syntax, deployment-tool, devops, automation, command-line, macos, linux

## Member repositories
- laravel/envoy (main) score 91

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:11.399173+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:50:21.251597+00:00, confidence not recorded.
  - readme: https://github.com/laravel/envoy (fetched 2026-08-28T04:05:11.399173+00:00, sha cb45c1e94421)
  - homepage: https://laravel.com/docs/envoy (fetched 2026-08-29T11:22:49.523963+00:00, sha fd2a1f6ff54e)
  - site_page: https://laravel.com/framework/docs/releases (fetched 2026-08-29T11:22:49.526852+00:00, sha e870da111344)
  - site_page: https://laravel.com/framework/docs/upgrade (fetched 2026-08-29T11:22:49.528883+00:00, sha f4bea2afd761)
  - site_page: https://laravel.com/framework/docs/contributions (fetched 2026-08-29T11:22:49.531109+00:00, sha 3c2bd55c6cda)
  - site_page: https://laravel.com/framework/docs/installation (fetched 2026-08-29T11:22:49.533056+00:00, sha f4021c99cae5)
  - site_page: https://laravel.com/framework/docs/configuration (fetched 2026-08-29T11:22:49.535070+00:00, sha f3ff3ea947f6)
  - site_page: https://laravel.com/framework/docs/ai (fetched 2026-08-29T11:22:49.537106+00:00, sha e229d3831994)
  - site_page: https://laravel.com/framework/docs/structure (fetched 2026-08-29T11:22:49.538783+00:00, sha 82e318828708)
  - site_page: https://laravel.com/framework/docs/frontend (fetched 2026-08-29T11:22:49.540502+00:00, sha 781573f7eb3b)
- Data as of 2026-08-30T08:39:29.467469+00:00.