Token GitHub¶

Serve un Personal Access Token con permesso di leggere e scrivere le issue del repository target.

Issuebeam funziona su Windows, macOS e Linux — cambia solo il modo in cui esporti GITHUB_TOKEN. La CLI è identica ovunque: python scripts/github_issue.py.

Classic token¶

GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
Generate new token (classic)
Scope minimo: repo (oppure solo Issues con fine-grained sul singolo repo)
Copia il token — lo vedi una sola volta

Fine-grained token (consigliato per team)¶

Personal access tokens → Fine-grained tokens → Generate new token
Repository access: solo il repo del progetto (es. myorg/my-app)
Permissions → Issues: Read and write
Nessun altro permesso necessario

Dove mettere il token¶

Metodo	Funziona su	Pro	Contro
Variabile `GITHUB_TOKEN`	Win · Mac · Linux	Terminale e agenti AI	Riavvia IDE/shell dopo la modifica
`.secrets/github_token`	Tutti	Gitignored, semplice, portabile	File locale — mai committare
`.env`	Tutti	Comodo in dev	Rischio commit accidentale (gitignored)

Mai incollare il token in chat con l'agente, issue pubbliche o commit.

Imposta `GITHUB_TOKEN` (consigliato)¶

Windows

Apri Variabili d'ambiente → Variabili utente → Nuova…
Nome: GITHUB_TOKEN — Valore: github_pat_...
OK su tutte le finestre
Riavvia l'IDE (Cursor, VS Code, …) o apri un nuovo terminale

Extra: se il terminale dell'IDE non vede ancora la variabile, issuebeam legge anche il registry utente Windows (stesso valore) — nessun setup aggiuntivo.

macOS

Terminale / agenti CLI — aggiungi a ~/.zshrc o ~/.bashrc:

export GITHUB_TOKEN=github_pat_...

Poi source ~/.zshrc (o nuovo terminale).

App GUI (Cursor, VS Code dal Dock) — le variabili della shell non sempre arrivano alle app avviate dal launcher. Opzioni:

Avvia l'IDE dal terminale: cursor . o code .
Oppure usa .env / .secrets/github_token nel progetto (sotto)

Linux

Shell — aggiungi a ~/.bashrc, ~/.zshrc, o usa direnv nel repo:

export GITHUB_TOKEN=github_pat_...

Sessione utente systemd (opzionale, per tool GUI):

# ~/.config/environment.d/github.conf
GITHUB_TOKEN=github_pat_...

Logout e login. In alternativa .env o .secrets/github_token.

Alternativa: `.env` o `.secrets/` (tutti i SO)¶

.env nella root del repo (gitignored):

GITHUB_REPO=myorg/my-app
GITHUB_TOKEN=github_pat_...

.secrets/github_token — una riga, gitignored:

mkdir -p .secrets
printf '%s\n' 'github_pat_...' > .secrets/github_token
chmod 600 .secrets/github_token   # macOS / Linux

Verifica¶

python -c "import os; print('OK' if os.environ.get('GITHUB_TOKEN') else 'MANCANTE')"

Poi (dopo lo slug repository):

python scripts/github_issue.py list

Ordine di lettura token (CLI)¶

Lo script legge il token automaticamente:

GITHUB_TOKEN nell'ambiente del processo corrente
Solo Windows: variabile utente da registry (aiuta i terminali IDE)
.env nella root del repo
.secrets/github_token

Opzionale: `GITHUB_REPO` nell'ambiente¶

Stessi metodi di GITHUB_TOKEN — utile se lavori sempre sullo stesso repo:

export GITHUB_REPO=myorg/my-app