Vibe coding · Agenti AI · GitHub Issues

Bug in chat.
Issue su
GitHub.

Con LLM e iterazione rapida perdi il filo di bug, task e idee sparse in conversazione. Issuebeam collega qualsiasi agente AI (Cursor, Claude Code, Copilot, …) al tracker ufficiale su Windows, macOS e Linux: l'agente esegue python scripts/github_issue.py e crea issue vere — senza gh CLI e senza script PowerShell.

Vai al repository Come iniziare

CLI

Solo stdlib Python

Agenti

Cursor · Claude · Copilot

Win · macOS · Linux

MIT

Open source

issuebeam — ai agent

# utente in chat

«Apri issue per il bug del form login su Safari»

$ python scripts/github_issue.py create "[Bug] Login Safari redirect loop" --labels bug,priority-high

CREATA #12: [Bug] Login Safari redirect loop

$ python scripts/github_issue.py list

#12 open · bug · priority-high · area-frontend

→ backlog visibile al team, non sepolto in chat

➜ Prova con un bug vero

Caso tipico

Chat → issue #12

Zero gh CLI

urllib + token

01. Come funziona

Dalla chat al backlog ufficiale

Descrivi il lavoro in linguaggio naturale. L'agente verifica duplicati, crea l'issue con label corrette e referenzia il numero nei commit. GitHub Issues diventa la fonte di verità.

Parli in chat

«Traccia bug…», «Apri issue per…», «Elenca le issue aperte». Non serve ricordare la sintassi CLI.

L'agente esegue

Le istruzioni in AGENTS.md (e file per Cursor, Claude, Copilot) obbligano l'agente a lanciare lo script Python — non a chiederti comandi da incollare.

Issue su GitHub

Backlog condiviso, label, template web, chiusura automatica con Fixes #N nelle PR.

Tutte le piattaforme supportate

02. Domande frequenti

Prima di clonare

Cos'è Issuebeam?

Issuebeam è uno skeleton leggero che collega agenti AI di coding a GitHub Issues su Windows, macOS e Linux. L'agente esegue una CLI Python per creare, commentare e chiudere issue — senza gh CLI e senza script PowerShell. Funziona con Cursor, Claude Code, Copilot e qualsiasi agente che legga istruzioni nel repo ed esegua comandi shell.

Funziona solo con Cursor?

No. Cursor è il percorso più testato (.cursor/rules/github-issues.mdc), ma la stessa CLI funziona con Claude Code (CLAUDE.md + AGENTS.md), GitHub Copilot (.github/copilot-instructions.md), Windsurf, Cline, Gemini CLI, Codex CLI e uso manuale. Vedi la pagina Piattaforme o la guida MkDocs su /docs/it/platforms/overview/.

Serve la gh CLI?

No. Issuebeam usa uno script Python solo stdlib (urllib) che parla direttamente con l'API REST di GitHub. Ti basta Python e un Personal Access Token con permessi Issues read/write.

Come fa l'agente a usarlo?

Copia lo skeleton nel repo (o usa adopt.py). Ogni piattaforma legge un file istruzioni: AGENTS.md (universale), .cursor/rules/ per Cursor, CLAUDE.md per Claude Code, .github/copilot-instructions.md per Copilot. La regola obbliga l'agente a eseguire python scripts/github_issue.py da solo.

Posso adottarlo in un progetto esistente?

Sì. Esegui python scripts/adopt.py --target ../my-repo --repo myorg/my-app. Copia CLI, label, template issue e file istruzioni per più piattaforme, poi scrive tracker/github_repo con il tuo slug.

Dove metto il token?

Imposta GITHUB_TOKEN come variabile d'ambiente (Windows, macOS, Linux). Alternative: .env (gitignored) o .secrets/github_token. Su Windows la CLI può leggere anche le variabili utente dal registry se il terminale IDE non le eredita. Mai committare token o incollarli in chat.

Guida completa: MkDocs · Piattaforme

Bug in chat. Issue su GitHub.