Setup rapido

Come iniziare

Cinque passi per collegare un agente AI a GitHub Issues su Windows, macOS o Linux. Funziona sul repo issuebeam o su un progetto adottato con adopt.py. Cursor, Claude Code, Copilot e altro — vedi anche Piattaforme.

Token GitHub

Crea un Personal Access Token con permesso Issues: read & write sul repository target.

Imposta GITHUB_TOKEN nell'ambiente — vedi la guida token per Windows, macOS e Linux. Alternative: .env (gitignored) o .secrets/github_token (una riga).

                        # Verifica (dopo aver impostato il token)

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

Slug repository

Indica quale repo GitHub usare (owner/nome).

                        python -c "from pathlib import Path; Path('tracker/github_repo').write_text('myorg/my-app\n')"

                        # oppure in .env

                        GITHUB_REPO=myorg/my-app

Adotta in un altro progetto (opzionale)

Copia lo skeleton in un repo esistente con un comando.

python scripts/adopt.py --target ../my-repo --repo myorg/my-app

Label

Applica le label definite in tracker/labels.yml sul repo GitHub.

python scripts/github_issue.py labels --apply

Prima issue + agente AI

Prova la CLI, poi apri il progetto nel tuo agente (Cursor, Claude Code, Copilot, …) — le istruzioni sono già nel repo.

                        python scripts/github_issue.py create "[Bug] Test da setup" --labels bug

                        python scripts/github_issue.py list

Guida piattaforme Documentazione MkDocs