PHPackages                             terminus-plugin-project/terminus-hotfix-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. terminus-plugin-project/terminus-hotfix-plugin

ActiveTerminus-plugin[CLI &amp; Console](/categories/cli)

terminus-plugin-project/terminus-hotfix-plugin
==============================================

Hotfix - A Terminus plugin that adds command(s) to facilitate hotfixes on Pantheon sites.

021[4 issues](https://github.com/terminus-plugin-project/terminus-hotfix-plugin/issues)[1 PRs](https://github.com/terminus-plugin-project/terminus-hotfix-plugin/pulls)PHP

Since Jun 28Pushed 6y ago3 watchersCompare

[ Source](https://github.com/terminus-plugin-project/terminus-hotfix-plugin)[ Packagist](https://packagist.org/packages/terminus-plugin-project/terminus-hotfix-plugin)[ RSS](/packages/terminus-plugin-project-terminus-hotfix-plugin/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (2)Used By (0)

Terminus Hotfix Plugin
======================

[](#terminus-hotfix-plugin)

A [Terminus](http://github.com/pantheon-systems/terminus) plugin that adds the commands to facilitate hotfix workflows on [Pantheon](https://pantheon.io/) sites.

Demo Video
----------

[](#demo-video)

[![Terminus Hotfix Plugin Demo Video](assets/terminus-hotfix-plugin-repo-ss-with-play-button.png?raw=true)](https://youtu.be/T9ukNUGLXnE "Terminus Hotfix Plugin Demo Video")

Disclaimer
----------

[](#disclaimer)

While this plugin has worked well for us your mileage may vary due to local machine configuration. This repository is provided without warranty or direct support. Issues and questions may be filed in GitHub but their resolution is not guaranteed.

Installation
------------

[](#installation)

Clone this project into your Terminus plugins directory found at `$HOME/.terminus/plugins`. If the `$HOME/.terminus/plugins` directory does not exists you can safely create it. You will also need to run `composer install` in the plugin directory after cloning it. See [installing Terminus plugin](https://pantheon.io/docs/terminus/plugins/#install-plugins) for details.

Purpose
-------

[](#purpose)

A hotfix is the only way to push code directly to Live without having to go through Dev and Test. Any damage to the source code will be the responsibility of the user. The intended use case is for critical security releases or bug fixes that need to be deployed as quickly and easily as possible. Hotfixes should be used with care and only in emergency situations. Hotfixes should be the exception, not the norm.

Currently hotfix deployments, emergency updates to test/live that skip the normal workflow and potentially undeployed code in `master`, need to be done manually and require more advanced git skills. See the [hotfix doc](https://pantheon.io/docs/hotfixes/) for details. This plugin aims to make that process easier.

Requirements
------------

[](#requirements)

- [Terminus](https://github.com/pantheon-systems/terminus) `1.8.0` or greater
- [git command line](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)

Commands
--------

[](#commands)

- `terminus hotfix:env:git-ref .` - returns the deployed git reference of the specifiied environment.
- `terminus hotfix:env:create . ` - creates a new environment for the site with code, database and files from the environment by checking out the lastest git tag associated with environment.
- `terminus hotfix:env:deploy . ` - deploy the changes from the specified environment directly to for the site , skipping the normal workflow, and rebase the changes back to the `master` branch/dev environment.

License
-------

[](#license)

MIT

Known Issues
------------

[](#known-issues)

- `terminus hotfix:env:deploy` will fail on environments that have had a backup restored **without** a code deployment since the backup.

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/24785343?v=4)[Terminus Plugin Project](/maintainers/terminus-plugin-project)[@terminus-plugin-project](https://github.com/terminus-plugin-project)

---

Top Contributors

[![ataylorme](https://avatars.githubusercontent.com/u/2133004?v=4)](https://github.com/ataylorme "ataylorme (9 commits)")

### Embed Badge

![Health badge](/badges/terminus-plugin-project-terminus-hotfix-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/terminus-plugin-project-terminus-hotfix-plugin/health.svg)](https://phpackages.com/packages/terminus-plugin-project-terminus-hotfix-plugin)
```

###  Alternatives

[wp-cli/wp-cli

WP-CLI framework

5.1k17.2M320](/packages/wp-cli-wp-cli)[consolidation/annotated-command

Initialize Symfony Console commands from annotated command class methods.

22569.8M19](/packages/consolidation-annotated-command)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[php-tui/php-tui

Comprehensive TUI library heavily influenced by Ratatui

589747.0k6](/packages/php-tui-php-tui)[codedungeon/php-cli-colors

Liven up you PHP Console Apps with standard colors

10210.1M26](/packages/codedungeon-php-cli-colors)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
