How can I use gama?

[canack]

How can I create PAT?

[github-actions]

🤖 AI Issue Assistant

Creating a Personal Access Token (PAT) for GitHub

1. Navigate to GitHub Token Generation

• Go to GitHub Settings
• Click on "Generate new token" in the Fine-grained tokens section

2. Token Configuration

Basic Setup

• Give your token a descriptive name
• Choose token expiration (recommended: 30 days)

Repository Access

• Select Only select repositories for more granular control
• Choose the specific repositories you want to manage

Required Permissions

For GAMA, you'll need the following repository permissions:

1. Actions Permissions:

   • Read and write access to Actions
   • Allows triggering and reading workflow runs

2. Metadata Permissions:

   • Read-only access to repository metadata
   • Enables basic repository information retrieval

3. Contents Permissions:

   • Read-only access to repository contents
   • Required for workflow file inspection

3. Generate Token

• Review permissions carefully
• Click "Generate token"
• Important: Copy the token immediately, as you won't see it again

4. Token Usage in GAMA

# In ~/.config/gama/config.yaml
github:
  token: <your_generated_token>

Security Best Practices

• Use the most restrictive permissions possible
• Set a short expiration time
• Never share your token publicly
• Regenerate tokens periodically

Troubleshooting

• If token doesn't work, verify:
  1. Correct permissions are set
  2. Token hasn't expired
  3. Token is for correct GitHub account

Alternative Methods

• Use GitHub CLI: gh auth token
• Environment variable: GITHUB_TOKEN

Recommended Token Scope

✅ Minimal required permissions
✅ Limited to specific repositories
✅ Short expiration period

---

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 user seeking guidance on how to create a Personal Access Token (PAT), which clearly indicates a question about usage or documentation. The 'question' label is highly appropriate as the user is requesting information, while the 'documentation' label is relevant because the query suggests a need for clearer guidance or documentation about the process.

---

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