[{"data":1,"prerenderedAt":1287},["ShallowReactive",2],{"docs-pages-it":3,"doc-it-recipe-error-to-agent":341},[4,9,15,20,25,30,35,41,52,60,69,77,85,93,97,106,110,118,123,128,133,139,144,149,154,159,164,169,175,180,185,190,195,201,206,211,216,221,226,231,236,241,246,251,256,261,266,271,276,281,286,292,297,301,306,311,316,321,326,331,336],{"path":5,"title":6,"description":7,"order":8,"group":8,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fpermissions","Chi può fare cosa","[object Object]",null,{"path":10,"title":11,"description":12,"order":13,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Finstallation","Installazione","Installa CloseYourIt sul tuo server con un solo comando.",1,"start",{"path":16,"title":17,"description":18,"order":19,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fsettings","Impostazioni","Ogni impostazione del file .env, a cosa serve e quali non vanno mai cambiate.",2,{"path":21,"title":22,"description":23,"order":24,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fdatabase","Database","Cos'è il database, cosa contiene, quanto restano i dati e quanto spazio occupa.",3,{"path":26,"title":27,"description":28,"order":29,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fupdates-and-backups","Aggiornamenti e backup","Aggiorna a una versione nuova, fai e ripristina il backup del database, controlla l'installazione.",4,{"path":31,"title":32,"description":33,"order":34,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Ftroubleshooting","Risolvere i problemi","Cosa controllare quando installazione, certificato, email o dati in arrivo non funzionano.",5,{"path":36,"title":37,"description":38,"order":39,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fconnect-your-apps","Collega le tue app","Tutti gli strumenti che mandano dati a CloseYourIt, e cosa raccoglie ognuno.",6,"connect",{"path":42,"title":43,"description":44,"order":45,"group":8,"parent":46,"package":47,"note":48,"collects":49,"status":8},"\u002Fdocs\u002Fsdk-ruby","Ruby \u002F Rails","La gemma closeyourit-ruby manda errori, log, query lente e metriche dei job da un'app Rails.",7,"connect-your-apps","closeyourit-ruby","Errori, log, query e metodi lenti, job in background.",{"errors":50,"logs":50,"performance":50,"visits":51,"servers":51},"full","none",{"path":53,"title":54,"description":55,"order":56,"group":8,"parent":46,"package":57,"note":58,"collects":59,"status":8},"\u002Fdocs\u002Fsdk-javascript","JavaScript","Il pacchetto @bussolabs\u002Fcloseyourit-js funziona nel browser e su Node 20.16 o più recente.",8,"@bussolabs\u002Fcloseyourit-js","Browser e Node, adattatori framework e query database dalla 0.13.0.",{"errors":50,"logs":50,"performance":50,"visits":50,"servers":51},{"path":61,"title":62,"description":63,"order":64,"group":8,"parent":46,"package":65,"note":66,"collects":67,"status":8},"\u002Fdocs\u002Fsdk-dart","Dart \u002F Flutter","Il pacchetto closeyourit cattura gli errori delle app Flutter, anche quando il telefono è senza rete.",9,"closeyourit","Errori, log e metriche pubblici dalla 0.9.3.",{"errors":50,"logs":68,"performance":68,"visits":51,"servers":51},"partial",{"path":70,"title":71,"description":72,"order":73,"group":8,"parent":46,"package":65,"note":74,"collects":75,"status":76},"\u002Fdocs\u002Fsdk-python","Python","Il pacchetto closeyourit manda errori, log e metriche da applicazioni Python lato server.",10,"Lato server. SQLAlchemy; query Django e FastAPI\u002FStarlette dalla 0.4.0.",{"errors":50,"logs":50,"performance":68,"visits":51,"servers":51},"pre_alpha",{"path":78,"title":79,"description":80,"order":81,"group":8,"parent":46,"package":82,"note":83,"collects":84,"status":8},"\u002Fdocs\u002Fsdk-sentry","SDK Sentry","Invia errori con un SDK Sentry compatibile; sessioni e crash hanno profili separati.",11,"Sentry SDK","Errori compatibili; sessioni e crash richiedono il profilo verificato.",{"errors":50,"logs":51,"performance":51,"visits":51,"servers":51},{"path":86,"title":87,"description":88,"order":89,"group":8,"parent":46,"package":90,"note":91,"collects":92,"status":8},"\u002Fdocs\u002Fagent-server","Agent per server","Un piccolo programma sul server che manda lo stato della macchina ogni 60 secondi.",12,"closeyourit-agent","CPU, memoria, dischi, rete, container e servizi.",{"errors":51,"logs":68,"performance":51,"visits":51,"servers":50},{"path":94,"title":95,"description":96,"order":89,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fnuxt","Vue e Nuxt","Collega gli errori del browser Nuxt e del server Nitro senza esporre un token segreto.",{"path":98,"title":99,"description":100,"order":101,"group":8,"parent":46,"package":102,"note":103,"collects":104,"status":105},"\u002Fdocs\u002Fagent-kubernetes","Kubernetes","Un osservatore in sola lettura del cluster: una copia sola per cluster.",13,"closeyourit-kube","Macchine, app ed eventi di errore del cluster.",{"errors":51,"logs":51,"performance":51,"visits":51,"servers":50},"coming",{"path":107,"title":108,"description":109,"order":101,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fopentelemetry","OpenTelemetry","Invia tracce, metriche e log dei server attraverso il ricevitore OTLP facoltativo.",{"path":111,"title":112,"description":113,"order":114,"group":8,"parent":46,"package":115,"note":116,"collects":117,"status":8},"\u002Fdocs\u002Fcli","CLI cyi","Il comando closeyourit, in breve cyi: gestisci progetti, errori e ticket dal terminale.",14,"@bussolabs\u002Fcloseyourit-cli","Non raccoglie dati: comanda CloseYourIt dal terminale.",{"errors":51,"logs":51,"performance":51,"visits":51,"servers":51},{"path":119,"title":120,"description":121,"order":122,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fhttp-api","API HTTP","Manda errori, log, metriche e visite con semplici richieste HTTP, senza un SDK.",15,{"path":124,"title":125,"description":126,"order":127,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fgithub-app","GitHub","Collega i repository GitHub a ticket e rilasci con una GitHub App tua.",16,{"path":129,"title":130,"description":131,"order":132,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fingest-gateway","Gateway di ingest","Tieni al sicuro errori, log e metriche in arrivo quando l'app è lenta o sta ripartendo.",17,{"path":134,"title":135,"description":136,"order":137,"group":138,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fai","AI","Accendi assistente, analisi, dettatura e ricerca intelligente con una chiave CloseYourIt AI o con il tuo provider.",18,"automation",{"path":140,"title":141,"description":142,"order":143,"group":138,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fautomator","Automator","Fai lavorare i ticket in automatico su una tua macchina Linux, con Claude Code, Codex o tutti e due.",19,{"path":145,"title":146,"description":147,"order":148,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fstack-coverage","Framework e copertura degli stack","Scegli un SDK pubblicato o verifica i limiti di un’integrazione provata localmente.",20,{"path":150,"title":151,"description":152,"order":153,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fmonitoring","Tracce, misure e sessioni","Esplora i nuovi segnali, confronta le versioni e ricostruisci le posizioni originali degli errori.",21,{"path":155,"title":156,"description":157,"order":158,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fnode-database","Database Node","Monitora query lente e ripetute con pg, mysql2, Drizzle e Prisma PostgreSQL.",22,{"path":160,"title":161,"description":162,"order":163,"group":138,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fclaude-code","Claude Code","CloseYourIt dentro Claude Code, in una colonna accanto alla conversazione con produzione e i tuoi ticket aperti.",23,{"path":165,"title":166,"description":167,"order":168,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fcollected-data","Dati inviati dagli SDK","Per ogni SDK, cosa manda da solo, cosa solo se lo accendi e cosa non esce mai dalla tua app.",24,{"path":170,"title":171,"description":172,"order":173,"group":174,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipes","Ricette","Quattro guide dall'inizio alla fine, ognuna attraverso più parti di CloseYourIt.",25,"recipes",{"path":176,"title":177,"description":178,"order":179,"group":8,"parent":174,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipe-payment-alert","Un avviso su Telegram quando un pagamento fallisce","La tua app Rails scrive il pagamento fallito, e il messaggio ti arriva in una chat Telegram.",26,{"path":181,"title":182,"description":183,"order":184,"group":8,"parent":174,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipe-error-to-agent","Dall'errore al ticket lavorato da un agente","Un errore del browser diventa un ticket, e un agente sulla tua macchina propone la correzione da approvare.",27,{"path":186,"title":187,"description":188,"order":189,"group":8,"parent":174,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipe-status-page","Controllo dei siti con pagina di stato pubblica","CloseYourIt controlla che il sito risponda, ti avvisa quando cade e mostra lo stato ai tuoi clienti.",28,{"path":191,"title":192,"description":193,"order":194,"group":8,"parent":174,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipe-request-logs","Log legati alla stessa richiesta","I messaggi della tua app Rails si mettono accanto all'errore che spiegano, richiesta per richiesta.",29,{"path":196,"title":197,"description":198,"order":199,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Ftickets","Ticket e idee","Apri e segui i ticket sulla bacheca, raccoglili in milestone, fai domande e trasforma le idee votate in lavoro.",30,"use",{"path":202,"title":203,"description":204,"order":205,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Ferrors","Errori","Come gli errori delle tue app diventano righe uniche, e come risolverli, ignorarli, fonderli o trasformarli in ticket.",31,{"path":207,"title":208,"description":209,"order":210,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fperformance","Performance","Trova le query e i metodi lenti, leggi i problemi riconosciuti da soli e ricevi un avviso quando ne compare uno.",32,{"path":212,"title":213,"description":214,"order":215,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Flogs","Log","Cerca i messaggi delle tue app, segui una richiesta dall'inizio alla fine e collega un messaggio a un errore o a un ticket.",33,{"path":217,"title":218,"description":219,"order":220,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fsecrets","Segreti","Password, chiavi e file riservati in un posto solo, per progetto e ambiente, letti dall'app senza un .env sul disco.",34,{"path":222,"title":223,"description":224,"order":225,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fservers","Server","Lo stato delle tue macchine in una pagina, con lo storico e gli avvisi quando qualcosa si rompe o si sta riempiendo.",35,{"path":227,"title":228,"description":229,"order":230,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fuptime","Uptime","Controlla che i tuoi siti rispondano, tiene il conto dei guasti e li mostra ai clienti su una pagina di stato.",36,{"path":232,"title":233,"description":234,"order":235,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fcrons","Lavori programmati","Accorgersi quando un lavoro che deve partire da solo smette di partire, o parte e finisce male.",37,{"path":237,"title":238,"description":239,"order":240,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Falerts","Avvisi","Le regole che fanno nascere un avviso, il centro notifiche e dove ognuno sceglie di riceverli.",38,{"path":242,"title":243,"description":244,"order":245,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fhelpdesk","Assistenza","Chi visita il sito di un progetto scrive al team con il bottone «Serve aiuto?», e la richiesta arriva nel progetto giusto.",39,{"path":247,"title":248,"description":249,"order":250,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fanalytics","Statistiche del sito","Quante persone visitano il sito, cosa guardano e da dove arrivano, senza cookie.",40,{"path":252,"title":253,"description":254,"order":255,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Freplays","Session replay","Registra la navigazione di chi usa il sito e la riguardi come un video, anche accanto a un errore.",41,{"path":257,"title":258,"description":259,"order":260,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Freleases","Release","Le versioni che girano in ogni ambiente, legate ai tag di GitHub, e gli errori che tornano dopo una correzione.",42,{"path":262,"title":263,"description":264,"order":265,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fvulnerabilities","Vulnerabilità","I problemi di sicurezza noti nelle librerie dei tuoi progetti e i linguaggi che non ricevono più correzioni.",43,{"path":267,"title":268,"description":269,"order":270,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fseo","SEO","CloseYourIt visita i tuoi siti come un motore di ricerca e ti dice cosa impedisce alle pagine di essere trovate.",44,{"path":272,"title":273,"description":274,"order":275,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fknowledge","Knowledge base","Scrivi note, decisioni e guide dei progetti, ritrovale per significato e fai domande con le fonti.",45,{"path":277,"title":278,"description":279,"order":280,"group":200,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fagents","Agenti AI","Quali ticket prendono gli agenti, cosa ti consegnano, dove decidi tu e come si misura ogni macchina.",46,{"path":282,"title":283,"description":284,"order":285,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog","Versioni","Ogni sistema di CloseYourIt con la sua ultima versione, e le note di ogni rilascio.",50,{"path":287,"title":288,"description":289,"order":290,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-app","App","Tutte le versioni stabili di App, dalla più recente.",51,"changelog",{"path":293,"title":294,"description":295,"order":296,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-cli","Riga di comando (cyi)","Tutte le versioni stabili di Riga di comando (cyi), dalla più recente.",52,{"path":298,"title":141,"description":299,"order":300,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-automator","Tutte le versioni stabili di Automator, dalla più recente.",53,{"path":302,"title":303,"description":304,"order":305,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-agent-server","Agente per server","Tutte le versioni stabili di Agente per server, dalla più recente.",54,{"path":307,"title":308,"description":309,"order":310,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-agent-kubernetes","Agente Kubernetes","Tutte le versioni stabili di Agente Kubernetes, dalla più recente.",55,{"path":312,"title":313,"description":314,"order":315,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-sdk-javascript","SDK JavaScript","Tutte le versioni stabili di SDK JavaScript, dalla più recente.",56,{"path":317,"title":318,"description":319,"order":320,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-sdk-ruby","SDK Ruby","Tutte le versioni stabili di SDK Ruby, dalla più recente.",57,{"path":322,"title":323,"description":324,"order":325,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-sdk-python","SDK Python","Tutte le versioni stabili di SDK Python, dalla più recente.",58,{"path":327,"title":328,"description":329,"order":330,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-sdk-dart","SDK Dart","Tutte le versioni stabili di SDK Dart, dalla più recente.",59,{"path":332,"title":333,"description":334,"order":335,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-skills","Skill per assistenti AI","Tutte le versioni stabili di Skill per assistenti AI, dalla più recente.",60,{"path":337,"title":338,"description":339,"order":340,"group":8,"parent":291,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-site","Sito e documentazione","Tutte le versioni stabili di Sito e documentazione, dalla più recente.",61,{"id":342,"title":182,"body":343,"collects":8,"description":183,"extension":1282,"group":8,"meta":1283,"navigation":497,"note":8,"order":184,"package":8,"parent":174,"path":181,"seo":1284,"status":8,"stem":1285,"__hash__":1286},"docs_it\u002Fdocs\u002Frecipe-error-to-agent.md",{"type":344,"value":345,"toc":1268},"minimark",[346,350,353,387,392,425,429,452,456,463,565,568,572,575,600,606,610,627,633,637,647,896,900,911,1103,1110,1114,1117,1144,1148,1165,1172,1176,1187,1218,1222,1225,1242,1245,1249,1264],[347,348,349],"p",{},"Un errore della tua app web diventa un ticket con un clic. Un agente, che gira su una tua macchina Linux, prende quel ticket, scrive un piano e la correzione, e si ferma a ogni passaggio che chiede una decisione: approvi tu il piano e il lavoro.",[347,351,352],{},"Prima di cominciare ti servono:",[354,355,356,360,363],"ul",{},[357,358,359],"li",{},"il codice dell'app in un repository GitHub;",[357,361,362],{},"l'accesso al server dell'installazione, per collegarla a GitHub al passo 6;",[357,364,365,366,370,371,373,374,378,379,382,383,386],{},"una macchina Linux per l'agente, con ",[367,368,369],"strong",{},"Codex"," installato e con l'accesso fatto e, se vuoi che lavori Claude, ",[367,372,161],{}," installato e con l'accesso fatto. Sono programmi di OpenAI e di Anthropic, ognuno con il suo abbonamento: installali seguendo le loro istruzioni. Installa Codex con ",[375,376,377],"code",{},"npm"," del tuo utente (per esempio quello di ",[375,380,381],{},"mise","), non con ",[375,384,385],{},"sudo npm -g",".",[388,389,391],"h2",{"id":390},"_1-crea-il-progetto-e-la-chiave","1. Crea il progetto e la chiave",[393,394,395,401,407],"ol",{},[357,396,397,398,386],{},"In CloseYourIt crea un progetto per l'app, per esempio ",[375,399,400],{},"web",[357,402,403,404,386],{},"Nelle impostazioni del progetto crea un ",[367,405,406],{},"token di ingest",[357,408,409,410,413,414,416,417,420,421,424],{},"Copia la ",[375,411,412],{},"publicKey"," e l'id del progetto. La ",[375,415,412],{}," non è segreta: è fatta per stare nel codice del browser. Il ",[375,418,419],{},"token"," segreto (",[375,422,423],{},"cyi_…",") non va mai nel browser.",[388,426,428],{"id":427},"_2-installa-lsdk","2. Installa l'SDK",[430,431,436],"pre",{"className":432,"code":433,"language":434,"meta":435,"style":435},"language-bash shiki shiki-themes github-light github-dark","npm install @bussolabs\u002Fcloseyourit-js\n","bash","",[375,437,438],{"__ignoreMap":435},[439,440,442,445,449],"span",{"class":441,"line":13},"line",[439,443,377],{"class":444},"sScJk",[439,446,448],{"class":447},"sZZnC"," install",[439,450,451],{"class":447}," @bussolabs\u002Fcloseyourit-js\n",[388,453,455],{"id":454},"_3-configuralo","3. Configuralo",[347,457,458,459,462],{},"Chiama ",[375,460,461],{},"init"," una volta, il prima possibile nella pagina:",[430,464,468],{"className":465,"code":466,"language":467,"meta":435,"style":435},"language-js shiki shiki-themes github-light github-dark","import * as CloseYourIt from \"@bussolabs\u002Fcloseyourit-js\"\n\nCloseYourIt.init({\n  endpointUrl: \"https:\u002F\u002Fbugs.example.com\",\n  publicKey: \"\u003Cchiave pubblica del token>\",\n  projectId: \"\u003Cid del progetto>\",\n  environment: \"production\",\n  release: \"web@1.4.2\",\n})\n","js",[375,469,470,493,499,509,520,530,540,550,560],{"__ignoreMap":435},[439,471,472,476,480,483,487,490],{"class":441,"line":13},[439,473,475],{"class":474},"szBVR","import",[439,477,479],{"class":478},"sj4cs"," *",[439,481,482],{"class":474}," as",[439,484,486],{"class":485},"sVt8B"," CloseYourIt ",[439,488,489],{"class":474},"from",[439,491,492],{"class":447}," \"@bussolabs\u002Fcloseyourit-js\"\n",[439,494,495],{"class":441,"line":19},[439,496,498],{"emptyLinePlaceholder":497},true,"\n",[439,500,501,504,506],{"class":441,"line":24},[439,502,503],{"class":485},"CloseYourIt.",[439,505,461],{"class":444},[439,507,508],{"class":485},"({\n",[439,510,511,514,517],{"class":441,"line":29},[439,512,513],{"class":485},"  endpointUrl: ",[439,515,516],{"class":447},"\"https:\u002F\u002Fbugs.example.com\"",[439,518,519],{"class":485},",\n",[439,521,522,525,528],{"class":441,"line":34},[439,523,524],{"class":485},"  publicKey: ",[439,526,527],{"class":447},"\"\u003Cchiave pubblica del token>\"",[439,529,519],{"class":485},[439,531,532,535,538],{"class":441,"line":39},[439,533,534],{"class":485},"  projectId: ",[439,536,537],{"class":447},"\"\u003Cid del progetto>\"",[439,539,519],{"class":485},[439,541,542,545,548],{"class":441,"line":45},[439,543,544],{"class":485},"  environment: ",[439,546,547],{"class":447},"\"production\"",[439,549,519],{"class":485},[439,551,552,555,558],{"class":441,"line":56},[439,553,554],{"class":485},"  release: ",[439,556,557],{"class":447},"\"web@1.4.2\"",[439,559,519],{"class":485},[439,561,562],{"class":441,"line":64},[439,563,564],{"class":485},"})\n",[347,566,567],{},"Da qui le eccezioni non gestite e le Promise rifiutate arrivano a CloseYourIt da sole, con i clic, la navigazione e le richieste che le hanno precedute.",[388,569,571],{"id":570},"_4-guarda-lerrore","4. Guarda l'errore",[347,573,574],{},"Per provare, lancia un errore in una pagina dell'app, per esempio da un pulsante:",[430,576,578],{"className":465,"code":577,"language":467,"meta":435,"style":435},"throw new Error(\"Checkout total is NaN\")\n",[375,579,580],{"__ignoreMap":435},[439,581,582,585,588,591,594,597],{"class":441,"line":13},[439,583,584],{"class":474},"throw",[439,586,587],{"class":474}," new",[439,589,590],{"class":444}," Error",[439,592,593],{"class":485},"(",[439,595,596],{"class":447},"\"Checkout total is NaN\"",[439,598,599],{"class":485},")\n",[347,601,602,603,605],{},"Apri ",[367,604,203],{},": l'errore è lì, in una riga. Aprilo per leggere le righe di codice da cui è passato e cosa è successo prima.",[388,607,609],{"id":608},"_5-trasforma-lerrore-in-ticket","5. Trasforma l'errore in ticket",[393,611,612,618,621],{},[357,613,614,615,386],{},"Nella pagina dell'errore premi ",[367,616,617],{},"Promuovi a ticket",[357,619,620],{},"Guarda l'anteprima: progetto, titolo, il punto del codice, quante volte è successo.",[357,622,623,624,386],{},"Premi ",[367,625,626],{},"Crea il ticket",[347,628,629,630,386],{},"Nasce un ticket di tipo Bug, collegato all'errore. Dal terminale lo stesso passo è ",[375,631,632],{},"cyi errors promote \u003Cid> --project web",[388,634,636],{"id":635},"_6-collega-linstallazione-a-github","6. Collega l'installazione a GitHub",[347,638,639,640,643,644,646],{},"L'agente lavora sul codice del repository e consegna la correzione come pull request. L'installazione arriva a GitHub con ",[367,641,642],{},"una GitHub App sua",", creata una volta. Se la scheda ",[367,645,125],{}," del progetto mostra già i tuoi repository, salta al punto 4.",[393,648,649,722,732,884],{},[357,650,651,652,655,656],{},"Su GitHub apri ",[367,653,654],{},"Settings → Developer settings → GitHub Apps → New GitHub App"," e compila:",[354,657,658,672,681,707],{},[357,659,660,663,664,667,668,671],{},[367,661,662],{},"Callback URL",": ",[375,665,666],{},"https:\u002F\u002Fbugs.example.com\u002Fmember\u002Fintegrations\u002Fgithub\u002Fcallback",", e spunta ",[367,669,670],{},"Request user authorization (OAuth) during installation",";",[357,673,674,663,677,680],{},[367,675,676],{},"Webhook URL",[375,678,679],{},"https:\u002F\u002Fbugs.example.com\u002Fgithub\u002Fwebhook",", con un segreto che generi tu;",[357,682,683,684,688,689,688,692,695,696,699,700,688,703,706],{},"permessi sul repository: ",[685,686,687],"em",{},"Contents"," lettura e scrittura, ",[685,690,691],{},"Pull requests",[685,693,694],{},"Actions"," lettura, ",[685,697,698],{},"Environments"," e ",[685,701,702],{},"Secrets",[685,704,705],{},"Metadata"," lettura;",[357,708,709,710,713,714,713,717,713,719,386],{},"eventi: ",[685,711,712],{},"Push",", ",[685,715,716],{},"Create",[685,718,258],{},[685,720,721],{},"Pull request",[357,723,724,725,728,729,386],{},"Crea la App, poi genera una ",[367,726,727],{},"chiave privata"," e un ",[367,730,731],{},"client secret",[357,733,734,735,738,739,742,743],{},"Sul server aggiungi queste righe a ",[375,736,737],{},"\u002Fopt\u002Fcloseyourit\u002F.env",", poi lancia ",[375,740,741],{},"closeyourit restart",":",[430,744,746],{"className":432,"code":745,"language":434,"meta":435,"style":435},"GH_APP_ID=\u003Cl'ID della App>\nGH_APP_SLUG=\u003Cil nome nell'indirizzo della App>\nGH_APP_PRIVATE_KEY=\u003Cla chiave privata, su una riga con \\n>\nGH_APP_CLIENT_ID=\u003Cil Client ID mostrato nella pagina della App>\nGH_APP_CLIENT_SECRET=\u003Cil client secret>\nGH_WEBHOOK_SECRET=\u003Cil segreto del webhook>\n",[375,747,748,759,775,808,841,861],{"__ignoreMap":435},[439,749,750,753,756],{"class":441,"line":13},[439,751,752],{"class":485},"GH_APP_ID",[439,754,755],{"class":474},"=\u003C",[439,757,758],{"class":447},"l'ID della App>\n",[439,760,761,764,767,770,772],{"class":441,"line":19},[439,762,763],{"class":447},"GH_APP_SLUG=\u003Cil nome nell'indirizzo",[439,765,766],{"class":444}," della",[439,768,769],{"class":447}," Ap",[439,771,347],{"class":485},[439,773,774],{"class":474},">\n",[439,776,777,780,782,785,788,791,794,797,800,803,806],{"class":441,"line":24},[439,778,779],{"class":485},"GH_APP_PRIVATE_KEY",[439,781,755],{"class":474},[439,783,784],{"class":447},"la",[439,786,787],{"class":444}," chiave",[439,789,790],{"class":447}," privata,",[439,792,793],{"class":447}," su",[439,795,796],{"class":447}," una",[439,798,799],{"class":447}," riga",[439,801,802],{"class":447}," con",[439,804,805],{"class":478}," \\n",[439,807,774],{"class":474},[439,809,810,813,815,818,821,824,827,830,833,835,837,839],{"class":441,"line":29},[439,811,812],{"class":485},"GH_APP_CLIENT_ID",[439,814,755],{"class":474},[439,816,817],{"class":447},"il",[439,819,820],{"class":444}," Client",[439,822,823],{"class":447}," ID",[439,825,826],{"class":447}," mostrato",[439,828,829],{"class":447}," nella",[439,831,832],{"class":447}," pagina",[439,834,766],{"class":447},[439,836,769],{"class":447},[439,838,347],{"class":485},[439,840,774],{"class":474},[439,842,843,846,848,850,853,856,859],{"class":441,"line":34},[439,844,845],{"class":485},"GH_APP_CLIENT_SECRET",[439,847,755],{"class":474},[439,849,817],{"class":447},[439,851,852],{"class":444}," client",[439,854,855],{"class":447}," secre",[439,857,858],{"class":485},"t",[439,860,774],{"class":474},[439,862,863,866,868,870,873,876,879,882],{"class":441,"line":39},[439,864,865],{"class":485},"GH_WEBHOOK_SECRET",[439,867,755],{"class":474},[439,869,817],{"class":447},[439,871,872],{"class":444}," segreto",[439,874,875],{"class":447}," del",[439,877,878],{"class":447}," webhoo",[439,880,881],{"class":485},"k",[439,883,774],{"class":474},[357,885,886,887,889,890,892,893,386],{},"Nel progetto ",[375,888,400],{}," apri la scheda ",[367,891,125],{},", scegli il repository dell'app e premi ",[367,894,895],{},"Aggancia repo",[388,897,899],{"id":898},"_7-collega-una-macchina-per-lagente","7. Collega una macchina per l'agente",[347,901,902,903,906,907,910],{},"L'agente gira su una tua macchina Linux, con il tuo abbonamento: il codice resta lì. La macchina ha bisogno di Linux ",[375,904,905],{},"x86_64"," o ",[375,908,909],{},"arm64"," con systemd 254 o più recente, più Codex e Claude Code come detto all'inizio.",[393,912,913,950,1003,1087,1093,1096],{},[357,914,915,916,713,919,922,923],{},"Installa ",[375,917,918],{},"bubblewrap",[375,920,921],{},"socat"," e il portachiavi di sistema:",[430,924,926],{"className":432,"code":925,"language":434,"meta":435,"style":435},"sudo apt install bubblewrap socat gnome-keyring libsecret-tools\n",[375,927,928],{"__ignoreMap":435},[439,929,930,933,936,938,941,944,947],{"class":441,"line":13},[439,931,932],{"class":444},"sudo",[439,934,935],{"class":447}," apt",[439,937,448],{"class":447},[439,939,940],{"class":447}," bubblewrap",[439,942,943],{"class":447}," socat",[439,945,946],{"class":447}," gnome-keyring",[439,948,949],{"class":447}," libsecret-tools\n",[357,951,952,953],{},"Su un server senza interfaccia grafica, crea la raccolta «login» del portachiavi, con l'utente che farà girare l'agente:",[430,954,956],{"className":432,"code":955,"language":434,"meta":435,"style":435},"pkill -u \"$(id -u)\" gnome-keyring-d\nprintf '\\n' | gnome-keyring-daemon --unlock --components=secrets --daemonize\n",[375,957,958,980],{"__ignoreMap":435},[439,959,960,963,966,969,972,974,977],{"class":441,"line":13},[439,961,962],{"class":444},"pkill",[439,964,965],{"class":478}," -u",[439,967,968],{"class":447}," \"$(",[439,970,971],{"class":444},"id",[439,973,965],{"class":478},[439,975,976],{"class":447},")\"",[439,978,979],{"class":447}," gnome-keyring-d\n",[439,981,982,985,988,991,994,997,1000],{"class":441,"line":19},[439,983,984],{"class":478},"printf",[439,986,987],{"class":447}," '\\n'",[439,989,990],{"class":474}," |",[439,992,993],{"class":444}," gnome-keyring-daemon",[439,995,996],{"class":478}," --unlock",[439,998,999],{"class":478}," --components=secrets",[439,1001,1002],{"class":478}," --daemonize\n",[357,1004,1005,1006,742,1008],{},"Su Ubuntu 24.04 e successivi, sblocca una volta l'isolamento che serve a ",[375,1007,918],{},[430,1009,1011],{"className":432,"code":1010,"language":434,"meta":435,"style":435},"sudo tee \u002Fetc\u002Fapparmor.d\u002Fbwrap >\u002Fdev\u002Fnull \u003C\u003C'PROFILE'\nabi \u003Cabi\u002F4.0>,\ninclude \u003Ctunables\u002Fglobal>\n\nprofile bwrap \u002Fusr\u002Fbin\u002Fbwrap flags=(unconfined) {\n  userns,\n  include if exists \u003Clocal\u002Fbwrap>\n}\nPROFILE\nsudo apparmor_parser -r \u002Fetc\u002Fapparmor.d\u002Fbwrap\n",[375,1012,1013,1035,1040,1045,1049,1054,1059,1064,1069,1074],{"__ignoreMap":435},[439,1014,1015,1017,1020,1023,1026,1029,1032],{"class":441,"line":13},[439,1016,932],{"class":444},[439,1018,1019],{"class":447}," tee",[439,1021,1022],{"class":447}," \u002Fetc\u002Fapparmor.d\u002Fbwrap",[439,1024,1025],{"class":474}," >",[439,1027,1028],{"class":447},"\u002Fdev\u002Fnull",[439,1030,1031],{"class":474}," \u003C\u003C",[439,1033,1034],{"class":447},"'PROFILE'\n",[439,1036,1037],{"class":441,"line":19},[439,1038,1039],{"class":447},"abi \u003Cabi\u002F4.0>,\n",[439,1041,1042],{"class":441,"line":24},[439,1043,1044],{"class":447},"include \u003Ctunables\u002Fglobal>\n",[439,1046,1047],{"class":441,"line":29},[439,1048,498],{"emptyLinePlaceholder":497},[439,1050,1051],{"class":441,"line":34},[439,1052,1053],{"class":447},"profile bwrap \u002Fusr\u002Fbin\u002Fbwrap flags=(unconfined) {\n",[439,1055,1056],{"class":441,"line":39},[439,1057,1058],{"class":447},"  userns,\n",[439,1060,1061],{"class":441,"line":45},[439,1062,1063],{"class":447},"  include if exists \u003Clocal\u002Fbwrap>\n",[439,1065,1066],{"class":441,"line":56},[439,1067,1068],{"class":447},"}\n",[439,1070,1071],{"class":441,"line":64},[439,1072,1073],{"class":447},"PROFILE\n",[439,1075,1076,1078,1081,1084],{"class":441,"line":73},[439,1077,932],{"class":444},[439,1079,1080],{"class":447}," apparmor_parser",[439,1082,1083],{"class":478}," -r",[439,1085,1086],{"class":447}," \u002Fetc\u002Fapparmor.d\u002Fbwrap\n",[357,1088,1089,1090,386],{},"In CloseYourIt apri ",[367,1091,1092],{},"Automator → Collega una macchina",[357,1094,1095],{},"Copia il comando e lancialo sulla macchina.",[357,1097,1098,1099,1102],{},"Lancia ",[375,1100,1101],{},"automator doctor"," sulla macchina: dice cosa manca ancora.",[347,1104,1105,1106,1109],{},"Su una macchina con solo Codex, imposta anche ",[375,1107,1108],{},"AUTOMATOR_WORK_ENGINE=codex"," nell'ambiente del servizio.",[388,1111,1113],{"id":1112},"_8-dai-il-via-libera-alla-macchina","8. Dai il via libera alla macchina",[347,1115,1116],{},"Una macchina appena collegata non lavora finché una persona non lo permette.",[393,1118,1119,1125,1130],{},[357,1120,602,1121,1124],{},[367,1122,1123],{},"Agenti"," e scegli la macchina.",[357,1126,623,1127,386],{},[367,1128,1129],{},"Certifica host",[357,1131,1132,1133,1136,1137,699,1140,1143],{},"In ",[367,1134,1135],{},"Dettagli e impostazioni"," controlla ",[367,1138,1139],{},"Chi fa il lavoro",[367,1141,1142],{},"Chi rilegge il lavoro",". Con due motori conviene che rilegga l'altro.",[388,1145,1147],{"id":1146},"_9-lascia-il-ticket-a-un-agente","9. Lascia il ticket a un agente",[393,1149,1150,1153],{},[357,1151,1152],{},"Apri il ticket del passo 5.",[357,1154,1155,1156,1158,1159,1162,1163,386],{},"Nel riquadro ",[367,1157,1123],{},", alla voce ",[367,1160,1161],{},"Chi lo lavora",", scegli ",[367,1164,1123],{},[347,1166,1167,1168,1171],{},"Dal terminale: ",[375,1169,1170],{},"cyi tickets eligibility \u003Ccodice> --project web --allow",". L'agente aspetta se il ticket dipende da un lavoro non finito o ha una domanda aperta che lo blocca.",[388,1173,1175],{"id":1174},"_10-approva-il-piano","10. Approva il piano",[347,1177,1178,1179,1182,1183,1186],{},"L'agente scrive prima un piano: cosa cambia e perché, i rischi, e quando il lavoro si potrà dire finito. Sul piano decide il ",[367,1180,1181],{},"CTO del progetto"," oppure, se il progetto non ne ha uno, il ",[367,1184,1185],{},"CTO dell'organizzazione",": impostane uno se sono vuoti.",[393,1188,1189,1202,1208],{},[357,1190,602,1191,1194,1195,1198,1199,386],{},[367,1192,1193],{},"Approvazioni",", oppure premi ",[375,1196,1197],{},"g"," e poi ",[375,1200,1201],{},"a",[357,1203,623,1204,1207],{},[367,1205,1206],{},"Valuta"," sul piano.",[357,1209,623,1210,1213,1214,1217],{},[367,1211,1212],{},"Approva il piano",". Se qualcosa non va, ",[367,1215,1216],{},"Respingi"," con un motivo: torna una versione nuova.",[388,1219,1221],{"id":1220},"_11-approva-il-lavoro","11. Approva il lavoro",[347,1223,1224],{},"L'agente scrive la correzione e consegna un resoconto: cosa ha fatto, quali file sono cambiati, quali test sono girati.",[354,1226,1227,1230],{},[357,1228,1229],{},"Se i controlli automatici del codice passano e chi rilegge lo accetta, il lavoro va avanti da solo.",[357,1231,1232,1233,1235,1236,1239,1240,386],{},"Altrimenti aspetta in ",[367,1234,1193],{}," un ",[367,1237,1238],{},"Approva il lavoro"," o un ",[367,1241,1216],{},[347,1243,1244],{},"Dopo lo staging il rilascio aspetta 2 ore. Se in staging non compaiono errori nuovi, va in produzione da solo.",[388,1246,1248],{"id":1247},"_12-chiudi-lerrore","12. Chiudi l'errore",[347,1250,1251,1252,1255,1256,1259,1260,1263],{},"Quando la correzione è in produzione, apri l'errore, premi ",[367,1253,1254],{},"Risolvi"," e scrivi la ",[367,1257,1258],{},"Causa"," e il ",[367,1261,1262],{},"Rimedio",". Se lo stesso errore torna da una release aggiornata, CloseYourIt lo riapre da solo.",[1265,1266,1267],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":435,"searchDepth":19,"depth":19,"links":1269},[1270,1271,1272,1273,1274,1275,1276,1277,1278,1279,1280,1281],{"id":390,"depth":19,"text":391},{"id":427,"depth":19,"text":428},{"id":454,"depth":19,"text":455},{"id":570,"depth":19,"text":571},{"id":608,"depth":19,"text":609},{"id":635,"depth":19,"text":636},{"id":898,"depth":19,"text":899},{"id":1112,"depth":19,"text":1113},{"id":1146,"depth":19,"text":1147},{"id":1174,"depth":19,"text":1175},{"id":1220,"depth":19,"text":1221},{"id":1247,"depth":19,"text":1248},"md",{},{"title":182,"description":183},"docs\u002Frecipe-error-to-agent","HNVc6bZi1LtUttCOrWg35x43kLDY7VhDH2QhvZvrL3w",1794441699754]