action-tmate
Debug GitHub Actions workflows via SSH or web shell by creating a tmate session on the runner.
What is action-tmate?
action-tmate is a GitHub Action that creates a tmate session on a workflow runner, providing SSH or web shell access for interactive debugging. It solves the problem of opaque CI/CD failures by allowing developers to inspect the live environment, run commands, and diagnose issues directly. This turns black-box workflow debugging into an interactive, transparent process.
Developers and DevOps engineers using GitHub Actions who need to debug complex workflow failures, test commands in the runner environment, or troubleshoot configuration issues in CI/CD pipelines.
It offers a straightforward, zero-configuration way to gain shell access to GitHub Actions runners, unlike manual logging or trial-and-error approaches. Its integration with GitHub's ecosystem and support for conditional execution make it a versatile tool for both proactive and reactive debugging.
Overview
Debug your GitHub Actions via SSH by using tmate to get access to the runner system itself.
Use Cases
Best For
- Debugging intermittent CI/CD failures that are hard to reproduce with logs alone
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
