Which problem does solve GAMA?

[canack]

We can trigger workflow via UI, why we should use GAMA?

[github-actions]

🤖 AI Issue Assistant

GAMA offers several unique advantages over traditional GitHub workflow triggering methods:

1. Enhanced Workflow Discovery

• Quickly list all triggerable workflows in a repository
• Provides a unified, terminal-based interface for workflow management
• Eliminates the need to navigate through GitHub's web interface

2. Advanced Input Handling

• Supports complex workflow inputs with intuitive UI
• Handles more than 10 workflow inputs using JSON format
• Provides visual guidance for input types (choices, booleans, strings)

# Example workflow with multiple inputs
name: Complex Workflow
on:
  workflow_dispatch:
    inputs:
      environment:
        type: choice
        options: [staging, production]
      debug_mode:
        type: boolean
      custom_config:
        type: string

3. Live Mode & Real-time Updates

• Automatically refresh workflow status at configurable intervals
• Monitor workflow runs without constant manual refreshing
• Configurable update frequency in config.yaml

settings:
  live_mode:
    enabled: true    # Enable live mode at startup
    interval: 15s    # Refresh every 15 seconds

4. Terminal-First Experience

• Native terminal UI for developers who prefer keyboard-driven workflows
• Fast, lightweight alternative to web interfaces
• Minimal context switching between terminal and browser

5. Advanced Workflow Management

• Rerun failed jobs
• Cancel ongoing workflows
• Open workflow runs directly in browser
• View comprehensive workflow history

6. Cross-Platform Compatibility

• Works on Linux, macOS, and Windows
• Docker support for easy deployment
• Consistent experience across different environments

Practical Use Cases

• Quick workflow triggering during development
• Monitoring CI/CD pipelines
• Managing complex, multi-input workflows
• Scripting and automation scenarios

Comparison with Web Interface

Feature	GitHub Web	GAMA
Input Complexity	Limited	Advanced
Speed	Slower	Faster
Keyboard Support	Minimal	Extensive
Live Updates	Manual	Automatic

Code Example: Workflow Triggering

// Programmatic workflow trigger
err := m.github.TriggerWorkflow(ctx, gu.TriggerWorkflowInput{
    Repository:   "termkit/gama",
    Branch:       "main",
    WorkflowFile: ".github/workflows/release.yaml",
    Content:      workflowInputs,
})

Conclusion

GAMA is not just a workflow trigger; it's a comprehensive GitHub Actions management tool designed for developers who value efficiency, keyboard navigation, and a streamlined terminal experience.

---

This analysis was performed by Issue Assistant. If you have any questions, please contact the repository maintainers.

[github-actions]

🏷️ AI Label Assistant

I've added the following labels to this issue:

• question
• documentation

Explanation:
The issue appears to be a clarification request about GAMA's purpose and workflow triggering, which strongly aligns with the 'question' label. There's also a potential documentation aspect as the user seems to be seeking more information about the tool's functionality, suggesting a need for clearer documentation.

---

This label analysis was performed by Issue Assistant. If you have any questions, please contact the repository maintainers.