Issuebeam¶

← Sito web (issuebeam.github.io) · Documentazione

Issuebeam collega agenti AI di coding a GitHub Issues con una CLI Python stdlib e file di istruzioni nel repository. Funziona su Windows, macOS e Linux con Cursor, Claude Code, Copilot e altro.

Documentazione bilingue

Questa documentazione è disponibile anche in inglese. Usa il selettore lingua in alto.

Cosa fa¶

Livello	Descrizione
CLI	`scripts/github_issue.py` — crea, elenca, commenta, chiude, importa issue
Regole agente	`AGENTS.md`, regola Cursor, istruzioni Copilot, `CLAUDE.md`, …
GitHub	Backlog ufficiale con label, template web, `Fixes #N` nelle PR

A chi serve¶

Sviluppi con vibe coding (LLM, iterazione rapida) e perdi bug e task sepolti in chat. Issuebeam sposta lo stato operativo su GitHub Issues — non su markdown sparsi.

Non solo Cursor. La stessa CLI funziona ovunque; cambia solo il percorso del file istruzioni per IDE.

Avvio rapido¶

python -c "from pathlib import Path; Path('tracker/github_repo').write_text('myorg/my-app\n')"
python scripts/github_issue.py labels --apply
python scripts/github_issue.py create "Test setup" --labels task
python scripts/github_issue.py list

Dettagli: Panoramica · Token · Piattaforme

Adotta nel tuo repo¶

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

Copia CLI, label, template e file istruzioni per più piattaforme.

Mappa documentazione¶

Sezione	Contenuto
Per iniziare	Problema, architettura, setup
Piattaforme	Cursor, Claude Code, Copilot, altro
Riferimento CLI	Tutti i comandi
Flusso agente	Frasi in linguaggio naturale
Riferimento	FAQ, sicurezza, troubleshooting

Anteprima e pubblicazione docs¶

pip install -r docs/requirements.txt
mkdocs serve

Anteprima su http://127.0.0.1:8000 — pubblicazione: python scripts/publish_docs.py, poi git push nel repo gemello issuebeam.github.io. Nessuna GitHub Action.