Skip to content
/ gama Public
forked from termkit/gama

Manage your GitHub Actions from Terminal with great UI 🧪

License

Notifications You must be signed in to change notification settings

VILJkid/gama

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Actions Manager (GAMA)

GAMA is a powerful terminal-based user interface tool designed to streamline the management of GitHub Actions workflows. It allows developers to list, trigger, and manage workflows with ease directly from the terminal.

gama demo

Key Features

  • Extended Workflow Inputs: Supports more than 10 workflow inputs using JSON format.
  • Workflow History: Conveniently list all historical runs of workflows in a repository.
  • Discoverability: Easily list all triggerable (dispatchable) workflows in a repository.
  • Workflow Management: Trigger specific workflows with custom inputs.

Getting Started

Prerequisites

Before using GAMA, you need to generate a GitHub token. Follow these instructions to create your token.

Configuration

YAML Configuration

Place a ~/.config/gama/config.yaml file in your home directory with the following content:

github:
  token: <your github token>

keys:
  switch_tab_right: shift+right
  switch_tab_left: shift+left
  quit: ctrl+c
  refresh: ctrl+r
  enter: enter
  tab: tab

Environment Variable Configuration

Alternatively, you can use an environment variable:

GITHUB_TOKEN="<your github token>" gama

Build & Installation

Using Docker

Run GAMA in a Docker container:

docker run --rm -it --env GITHUB_TOKEN="<your github token>" termkit/gama:latest

Download Binary

Download the latest binary from the releases page.

Build from Source

make build
# output: ./release/gama