[{"data":1,"prerenderedAt":1301},["ShallowReactive",2],{"docs-pages-en":3,"doc-en-recipe-error-to-agent":339},[4,9,15,20,25,30,35,41,52,60,69,77,84,92,96,105,109,117,122,127,132,138,143,148,153,158,163,168,174,179,184,189,194,200,205,210,215,220,225,230,235,240,245,250,255,260,265,270,275,280,285,291,296,300,304,309,314,319,324,329,334],{"path":5,"title":6,"description":7,"order":8,"group":8,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fpermissions","Who can do what","[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","Installation","Install CloseYourIt on your own server with one command.",1,"start",{"path":16,"title":17,"description":18,"order":19,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fsettings","Settings","Every setting in the .env file, what it does and which ones you must never change.",2,{"path":21,"title":22,"description":23,"order":24,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fdatabase","Database","What the database is, what is inside, how long data stays and how much room it takes.",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","Updates and backups","Update to a new version, back up and restore the database, check the install.",4,{"path":31,"title":32,"description":33,"order":34,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Ftroubleshooting","Troubleshooting","What to check when the install, the certificate, email or incoming data do not work.",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","Connect your apps","Every tool that sends data to CloseYourIt, and what each one collects.",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","The closeyourit-ruby gem sends errors, logs, slow queries and job metrics from a Rails app.",7,"connect-your-apps","closeyourit-ruby","Errors, logs, slow queries and methods, background jobs.",{"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","The @bussolabs\u002Fcloseyourit-js package works in the browser and on Node 20.16 or newer.",8,"@bussolabs\u002Fcloseyourit-js","Browser and Node, framework adapters and database queries from 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","The closeyourit package captures the errors of Flutter apps, even when the phone is offline.",9,"closeyourit","Public errors, logs and metrics from 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","The closeyourit package sends errors, logs and metrics from server-side Python applications.",10,"Server side. SQLAlchemy; Django query monitoring and FastAPI\u002FStarlette from 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":79,"note":82,"collects":83,"status":8},"\u002Fdocs\u002Fsdk-sentry","Sentry SDK","Send errors with a compatible Sentry SDK; sessions and crashes have separate profiles.",11,"Compatible errors; sessions and crashes require a verified profile.",{"errors":50,"logs":51,"performance":51,"visits":51,"servers":51},{"path":85,"title":86,"description":87,"order":88,"group":8,"parent":46,"package":89,"note":90,"collects":91,"status":8},"\u002Fdocs\u002Fagent-server","Server agent","A small program on the server that sends the state of the machine every 60 seconds.",12,"closeyourit-agent","CPU, memory, disks, network, containers and services.",{"errors":51,"logs":68,"performance":51,"visits":51,"servers":50},{"path":93,"title":94,"description":95,"order":88,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fnuxt","Vue and Nuxt","Connect Nuxt browser errors and Nitro server errors without exposing a server token.",{"path":97,"title":98,"description":99,"order":100,"group":8,"parent":46,"package":101,"note":102,"collects":103,"status":104},"\u002Fdocs\u002Fagent-kubernetes","Kubernetes","A read-only observer of the cluster: one copy per cluster.",13,"closeyourit-kube","Machines, apps and error events of the cluster.",{"errors":51,"logs":51,"performance":51,"visits":51,"servers":50},"coming",{"path":106,"title":107,"description":108,"order":100,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fopentelemetry","OpenTelemetry","Send server traces, metrics and logs through the optional OTLP receiver.",{"path":110,"title":111,"description":112,"order":113,"group":8,"parent":46,"package":114,"note":115,"collects":116,"status":8},"\u002Fdocs\u002Fcli","cyi CLI","The closeyourit command, cyi for short: manage projects, errors and tickets from the terminal.",14,"@bussolabs\u002Fcloseyourit-cli","It collects no data: it drives CloseYourIt from the terminal.",{"errors":51,"logs":51,"performance":51,"visits":51,"servers":51},{"path":118,"title":119,"description":120,"order":121,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fhttp-api","HTTP API","Send errors, logs, metrics and page views with plain HTTP requests, without an SDK.",15,{"path":123,"title":124,"description":125,"order":126,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fgithub-app","GitHub","Connect GitHub repositories to tickets and releases with your own GitHub App.",16,{"path":128,"title":129,"description":130,"order":131,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fingest-gateway","Ingest gateway","Keep incoming errors, logs and metrics safe when the app is slow or restarting.",17,{"path":133,"title":134,"description":135,"order":136,"group":137,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fai","AI","Turn on assistant, analysis, dictation and smart search with a CloseYourIt AI key or your own provider.",18,"automation",{"path":139,"title":140,"description":141,"order":142,"group":137,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fautomator","Automator","Let tickets be worked automatically on your own Linux machine, with Claude Code, Codex or both.",19,{"path":144,"title":145,"description":146,"order":147,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fstack-coverage","Frameworks and stack coverage","Choose a published SDK or understand the limits of a locally tested integration.",20,{"path":149,"title":150,"description":151,"order":152,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fmonitoring","Traces, measurements and sessions","Explore the new signals, compare releases and recover original error locations.",21,{"path":154,"title":155,"description":156,"order":157,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fnode-database","Node databases","Monitor slow and repeated queries with pg, mysql2, Drizzle and Prisma PostgreSQL.",22,{"path":159,"title":160,"description":161,"order":162,"group":137,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fclaude-code","Claude Code","CloseYourIt inside Claude Code, in a column next to the conversation with production and your open tickets.",23,{"path":164,"title":165,"description":166,"order":167,"group":40,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fcollected-data","Data the SDKs send","For each SDK, what it sends on its own, what only when you turn it on, and what never leaves your app.",24,{"path":169,"title":170,"description":171,"order":172,"group":173,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipes","Recipes","Four guides from start to finish, each one crossing several parts of CloseYourIt.",25,"recipes",{"path":175,"title":176,"description":177,"order":178,"group":8,"parent":173,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipe-payment-alert","A Telegram alert when a payment fails","Your Rails app writes the failed payment, and the message reaches you in a Telegram chat.",26,{"path":180,"title":181,"description":182,"order":183,"group":8,"parent":173,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipe-error-to-agent","From an error to a ticket worked by an agent","A browser error becomes a ticket, and an agent on your machine proposes the fix for you to approve.",27,{"path":185,"title":186,"description":187,"order":188,"group":8,"parent":173,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipe-status-page","Site checks with a public status page","CloseYourIt checks that your site answers, alerts you when it falls and shows the status to your customers.",28,{"path":190,"title":191,"description":192,"order":193,"group":8,"parent":173,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Frecipe-request-logs","Logs tied to the same request","The messages of your Rails app line up with the error they explain, request by request.",29,{"path":195,"title":196,"description":197,"order":198,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Ftickets","Tickets and ideas","Open and follow tickets on the board, group them into milestones, ask questions and turn voted ideas into work.",30,"use",{"path":201,"title":202,"description":203,"order":204,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Ferrors","Errors","How your apps' errors become single rows, and how to resolve, ignore, merge or turn them into tickets.",31,{"path":206,"title":207,"description":208,"order":209,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fperformance","Performance","Find slow queries and methods, read the problems detected automatically and get an alert when one appears.",32,{"path":211,"title":212,"description":213,"order":214,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Flogs","Logs","Search your apps' messages, follow a request from start to end and link a message to an error or a ticket.",33,{"path":216,"title":217,"description":218,"order":219,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fsecrets","Secrets","Passwords, keys and private files in one place, per project and environment, read by your app without a .env on disk.",34,{"path":221,"title":222,"description":223,"order":224,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fservers","Servers","The state of your machines on one page, with history and alerts when something breaks or fills up.",35,{"path":226,"title":227,"description":228,"order":229,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fuptime","Uptime","Check that your sites answer, keep count of outages and show them to customers on a status page.",36,{"path":231,"title":232,"description":233,"order":234,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fcrons","Scheduled jobs","Notice when a job that should run on its own stops running, or runs and ends badly.",37,{"path":236,"title":237,"description":238,"order":239,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Falerts","Alerts","The rules that create an alert, the notification center and where each person chooses to receive them.",38,{"path":241,"title":242,"description":243,"order":244,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fhelpdesk","Help desk","Visitors of a project's site write to the team with the \"Need help?\" button, and the request lands in the right project.",39,{"path":246,"title":247,"description":248,"order":249,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fanalytics","Site analytics","How many people visit the site, what they look at and where they come from, without cookies.",40,{"path":251,"title":252,"description":253,"order":254,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Freplays","Session replay","Record how people move through the site and watch it back like a video, even next to an error.",41,{"path":256,"title":257,"description":258,"order":259,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Freleases","Releases","The versions running in each environment, bound to GitHub tags, and the errors that come back after a fix.",42,{"path":261,"title":262,"description":263,"order":264,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fvulnerabilities","Vulnerabilities","Known security problems in your projects' libraries, and the languages that no longer get fixes.",43,{"path":266,"title":267,"description":268,"order":269,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fseo","SEO","CloseYourIt visits your sites like a search engine and tells you what keeps your pages from being found.",44,{"path":271,"title":272,"description":273,"order":274,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fknowledge","Knowledge base","Write notes, decisions and guides for your projects, find them by meaning and ask questions with sources.",45,{"path":276,"title":277,"description":278,"order":279,"group":199,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fagents","AI agents","Which tickets agents take, what they hand you, where you decide and how each machine is measured.",46,{"path":281,"title":282,"description":283,"order":284,"group":14,"parent":8,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog","Versions","Every CloseYourIt system with its latest version, and the notes of each release.",50,{"path":286,"title":287,"description":288,"order":289,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-app","App","Every stable version of App, newest first.",51,"changelog",{"path":292,"title":293,"description":294,"order":295,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-cli","Command line (cyi)","Every stable version of Command line (cyi), newest first.",52,{"path":297,"title":140,"description":298,"order":299,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-automator","Every stable version of Automator, newest first.",53,{"path":301,"title":86,"description":302,"order":303,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-agent-server","Every stable version of Server agent, newest first.",54,{"path":305,"title":306,"description":307,"order":308,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-agent-kubernetes","Kubernetes agent","Every stable version of Kubernetes agent, newest first.",55,{"path":310,"title":311,"description":312,"order":313,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-sdk-javascript","JavaScript SDK","Every stable version of JavaScript SDK, newest first.",56,{"path":315,"title":316,"description":317,"order":318,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-sdk-ruby","Ruby SDK","Every stable version of Ruby SDK, newest first.",57,{"path":320,"title":321,"description":322,"order":323,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-sdk-python","Python SDK","Every stable version of Python SDK, newest first.",58,{"path":325,"title":326,"description":327,"order":328,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-sdk-dart","Dart SDK","Every stable version of Dart SDK, newest first.",59,{"path":330,"title":331,"description":332,"order":333,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-skills","Skills for AI assistants","Every stable version of Skills for AI assistants, newest first.",60,{"path":335,"title":336,"description":337,"order":338,"group":8,"parent":290,"package":8,"note":8,"collects":8,"status":8},"\u002Fdocs\u002Fchangelog-site","Website and docs","Every stable version of Website and docs, newest first.",61,{"id":340,"title":181,"body":341,"collects":8,"description":182,"extension":1296,"group":8,"meta":1297,"navigation":495,"note":8,"order":183,"package":8,"parent":173,"path":180,"seo":1298,"status":8,"stem":1299,"__hash__":1300},"docs_en\u002Fdocs\u002Frecipe-error-to-agent.md",{"type":342,"value":343,"toc":1282},"minimark",[344,348,351,385,390,423,427,450,454,461,563,566,570,573,598,604,608,625,631,635,645,911,915,926,1119,1126,1130,1133,1160,1164,1180,1187,1191,1202,1233,1237,1240,1256,1259,1263,1278],[345,346,347],"p",{},"An error in your web app becomes a ticket with one click. An agent, running on a Linux machine of yours, takes that ticket, writes a plan and the fix, and stops at every step that needs a decision: you approve the plan and the work.",[345,349,350],{},"Before you start you need:",[352,353,354,358,361],"ul",{},[355,356,357],"li",{},"the code of the app in a GitHub repository;",[355,359,360],{},"access to the server of the installation, to connect it to GitHub in step 6;",[355,362,363,364,368,369,371,372,376,377,380,381,384],{},"a Linux machine for the agent, with ",[365,366,367],"strong",{},"Codex"," installed and signed in and, if you want Claude to do the work, ",[365,370,160],{}," installed and signed in. They are programs of OpenAI and Anthropic, each with its own subscription: install them following their own instructions. Install Codex with your user's ",[373,374,375],"code",{},"npm"," (for example the one from ",[373,378,379],{},"mise","), not with ",[373,382,383],{},"sudo npm -g",".",[386,387,389],"h2",{"id":388},"_1-create-the-project-and-the-key","1. Create the project and the key",[391,392,393,399,405],"ol",{},[355,394,395,396,384],{},"In CloseYourIt create a project for the app, for example ",[373,397,398],{},"web",[355,400,401,402,384],{},"In the project's settings create an ",[365,403,404],{},"ingest token",[355,406,407,408,411,412,414,415,418,419,422],{},"Copy the ",[373,409,410],{},"publicKey"," and the project id. The ",[373,413,410],{}," is not secret: it is made to live in browser code. Never put the secret ",[373,416,417],{},"token"," (",[373,420,421],{},"cyi_…",") in the browser.",[386,424,426],{"id":425},"_2-install-the-sdk","2. Install the SDK",[428,429,434],"pre",{"className":430,"code":431,"language":432,"meta":433,"style":433},"language-bash shiki shiki-themes github-light github-dark","npm install @bussolabs\u002Fcloseyourit-js\n","bash","",[373,435,436],{"__ignoreMap":433},[437,438,440,443,447],"span",{"class":439,"line":13},"line",[437,441,375],{"class":442},"sScJk",[437,444,446],{"class":445},"sZZnC"," install",[437,448,449],{"class":445}," @bussolabs\u002Fcloseyourit-js\n",[386,451,453],{"id":452},"_3-configure-it","3. Configure it",[345,455,456,457,460],{},"Call ",[373,458,459],{},"init"," once, as early as possible in the page:",[428,462,466],{"className":463,"code":464,"language":465,"meta":433,"style":433},"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: \"\u003Cpublic key of the token>\",\n  projectId: \"\u003Cproject id>\",\n  environment: \"production\",\n  release: \"web@1.4.2\",\n})\n","js",[373,467,468,491,497,507,518,528,538,548,558],{"__ignoreMap":433},[437,469,470,474,478,481,485,488],{"class":439,"line":13},[437,471,473],{"class":472},"szBVR","import",[437,475,477],{"class":476},"sj4cs"," *",[437,479,480],{"class":472}," as",[437,482,484],{"class":483},"sVt8B"," CloseYourIt ",[437,486,487],{"class":472},"from",[437,489,490],{"class":445}," \"@bussolabs\u002Fcloseyourit-js\"\n",[437,492,493],{"class":439,"line":19},[437,494,496],{"emptyLinePlaceholder":495},true,"\n",[437,498,499,502,504],{"class":439,"line":24},[437,500,501],{"class":483},"CloseYourIt.",[437,503,459],{"class":442},[437,505,506],{"class":483},"({\n",[437,508,509,512,515],{"class":439,"line":29},[437,510,511],{"class":483},"  endpointUrl: ",[437,513,514],{"class":445},"\"https:\u002F\u002Fbugs.example.com\"",[437,516,517],{"class":483},",\n",[437,519,520,523,526],{"class":439,"line":34},[437,521,522],{"class":483},"  publicKey: ",[437,524,525],{"class":445},"\"\u003Cpublic key of the token>\"",[437,527,517],{"class":483},[437,529,530,533,536],{"class":439,"line":39},[437,531,532],{"class":483},"  projectId: ",[437,534,535],{"class":445},"\"\u003Cproject id>\"",[437,537,517],{"class":483},[437,539,540,543,546],{"class":439,"line":45},[437,541,542],{"class":483},"  environment: ",[437,544,545],{"class":445},"\"production\"",[437,547,517],{"class":483},[437,549,550,553,556],{"class":439,"line":56},[437,551,552],{"class":483},"  release: ",[437,554,555],{"class":445},"\"web@1.4.2\"",[437,557,517],{"class":483},[437,559,560],{"class":439,"line":64},[437,561,562],{"class":483},"})\n",[345,564,565],{},"From now on unhandled exceptions and rejected Promises reach CloseYourIt by themselves, with the clicks, navigation and requests that came before.",[386,567,569],{"id":568},"_4-see-the-error","4. See the error",[345,571,572],{},"To try it, throw an error in a page of the app, for example from a button:",[428,574,576],{"className":463,"code":575,"language":465,"meta":433,"style":433},"throw new Error(\"Checkout total is NaN\")\n",[373,577,578],{"__ignoreMap":433},[437,579,580,583,586,589,592,595],{"class":439,"line":13},[437,581,582],{"class":472},"throw",[437,584,585],{"class":472}," new",[437,587,588],{"class":442}," Error",[437,590,591],{"class":483},"(",[437,593,594],{"class":445},"\"Checkout total is NaN\"",[437,596,597],{"class":483},")\n",[345,599,600,601,603],{},"Open ",[365,602,202],{},": the error is there as one row. Open it to read the lines of code it went through and what happened before.",[386,605,607],{"id":606},"_5-turn-the-error-into-a-ticket","5. Turn the error into a ticket",[391,609,610,616,619],{},[355,611,612,613,384],{},"On the error page press ",[365,614,615],{},"Promote to ticket",[355,617,618],{},"Check the preview: project, title, the place in the code, how many times it happened.",[355,620,621,622,384],{},"Press ",[365,623,624],{},"Create the ticket",[345,626,627,628,384],{},"A ticket of type Bug is born, linked to the error. From the terminal the same step is ",[373,629,630],{},"cyi errors promote \u003Cid> --project web",[386,632,634],{"id":633},"_6-connect-the-installation-to-github","6. Connect the installation to GitHub",[345,636,637,638,641,642,644],{},"The agent works on the code of the repository and hands over the fix as a pull request. The installation reaches GitHub through ",[365,639,640],{},"its own GitHub App",", created once. If the ",[365,643,124],{}," tab of the project already lists your repositories, skip to point 4.",[391,646,647,720,730,899],{},[355,648,649,650,653,654],{},"On GitHub open ",[365,651,652],{},"Settings → Developer settings → GitHub Apps → New GitHub App"," and fill in:",[352,655,656,670,679,704],{},[355,657,658,661,662,665,666,669],{},[365,659,660],{},"Callback URL",": ",[373,663,664],{},"https:\u002F\u002Fbugs.example.com\u002Fmember\u002Fintegrations\u002Fgithub\u002Fcallback",", and tick ",[365,667,668],{},"Request user authorization (OAuth) during installation",";",[355,671,672,661,675,678],{},[365,673,674],{},"Webhook URL",[373,676,677],{},"https:\u002F\u002Fbugs.example.com\u002Fgithub\u002Fwebhook",", with a secret you generate;",[355,680,681,682,686,687,686,690,693,694,697,698,686,700,703],{},"repository permissions: ",[683,684,685],"em",{},"Contents"," read and write, ",[683,688,689],{},"Pull requests",[683,691,692],{},"Actions"," read, ",[683,695,696],{},"Environments"," and ",[683,699,217],{},[683,701,702],{},"Metadata"," read;",[355,705,706,707,710,711,710,714,710,717,384],{},"events: ",[683,708,709],{},"Push",", ",[683,712,713],{},"Create",[683,715,716],{},"Release",[683,718,719],{},"Pull request",[355,721,722,723,726,727,384],{},"Create the App, then generate a ",[365,724,725],{},"private key"," and a ",[365,728,729],{},"client secret",[355,731,732,733,736,737,740,741],{},"On the server add these lines to ",[373,734,735],{},"\u002Fopt\u002Fcloseyourit\u002F.env",", then run ",[373,738,739],{},"closeyourit restart",":",[428,742,744],{"className":430,"code":743,"language":432,"meta":433,"style":433},"GH_APP_ID=\u003Cthe App ID>\nGH_APP_SLUG=\u003Cthe name in the App address>\nGH_APP_PRIVATE_KEY=\u003Cthe private key, on one line with \\n>\nGH_APP_CLIENT_ID=\u003Cthe Client ID shown on the App page>\nGH_APP_CLIENT_SECRET=\u003Cthe client secret>\nGH_WEBHOOK_SECRET=\u003Cthe webhook secret>\n",[373,745,746,769,797,829,861,881],{"__ignoreMap":433},[437,747,748,751,754,757,760,763,766],{"class":439,"line":13},[437,749,750],{"class":483},"GH_APP_ID",[437,752,753],{"class":472},"=\u003C",[437,755,756],{"class":445},"the",[437,758,759],{"class":442}," App",[437,761,762],{"class":445}," I",[437,764,765],{"class":483},"D",[437,767,768],{"class":472},">\n",[437,770,771,774,776,778,781,784,787,789,792,795],{"class":439,"line":19},[437,772,773],{"class":483},"GH_APP_SLUG",[437,775,753],{"class":472},[437,777,756],{"class":445},[437,779,780],{"class":442}," name",[437,782,783],{"class":445}," in",[437,785,786],{"class":445}," the",[437,788,759],{"class":445},[437,790,791],{"class":445}," addres",[437,793,794],{"class":483},"s",[437,796,768],{"class":472},[437,798,799,802,804,806,809,812,815,818,821,824,827],{"class":439,"line":24},[437,800,801],{"class":483},"GH_APP_PRIVATE_KEY",[437,803,753],{"class":472},[437,805,756],{"class":445},[437,807,808],{"class":442}," private",[437,810,811],{"class":445}," key,",[437,813,814],{"class":445}," on",[437,816,817],{"class":445}," one",[437,819,820],{"class":445}," line",[437,822,823],{"class":445}," with",[437,825,826],{"class":476}," \\n",[437,828,768],{"class":472},[437,830,831,834,836,838,841,844,847,849,851,853,856,859],{"class":439,"line":29},[437,832,833],{"class":483},"GH_APP_CLIENT_ID",[437,835,753],{"class":472},[437,837,756],{"class":445},[437,839,840],{"class":442}," Client",[437,842,843],{"class":445}," ID",[437,845,846],{"class":445}," shown",[437,848,814],{"class":445},[437,850,786],{"class":445},[437,852,759],{"class":445},[437,854,855],{"class":445}," pag",[437,857,858],{"class":483},"e",[437,860,768],{"class":472},[437,862,863,866,868,870,873,876,879],{"class":439,"line":34},[437,864,865],{"class":483},"GH_APP_CLIENT_SECRET",[437,867,753],{"class":472},[437,869,756],{"class":445},[437,871,872],{"class":442}," client",[437,874,875],{"class":445}," secre",[437,877,878],{"class":483},"t",[437,880,768],{"class":472},[437,882,883,886,888,890,893,895,897],{"class":439,"line":39},[437,884,885],{"class":483},"GH_WEBHOOK_SECRET",[437,887,753],{"class":472},[437,889,756],{"class":445},[437,891,892],{"class":442}," webhook",[437,894,875],{"class":445},[437,896,878],{"class":483},[437,898,768],{"class":472},[355,900,901,902,904,905,907,908,384],{},"In the ",[373,903,398],{}," project open the ",[365,906,124],{}," tab, pick the repository of the app and press ",[365,909,910],{},"Link repository",[386,912,914],{"id":913},"_7-connect-a-machine-for-the-agent","7. Connect a machine for the agent",[345,916,917,918,921,922,925],{},"The agent runs on a Linux machine of yours, with your subscription: the code stays there. The machine needs Linux ",[373,919,920],{},"x86_64"," or ",[373,923,924],{},"arm64"," with systemd 254 or newer, plus Codex and Claude Code as said at the start.",[391,927,928,965,1018,1103,1109,1112],{},[355,929,930,931,710,934,937,938],{},"Install ",[373,932,933],{},"bubblewrap",[373,935,936],{},"socat"," and the system keyring:",[428,939,941],{"className":430,"code":940,"language":432,"meta":433,"style":433},"sudo apt install bubblewrap socat gnome-keyring libsecret-tools\n",[373,942,943],{"__ignoreMap":433},[437,944,945,948,951,953,956,959,962],{"class":439,"line":13},[437,946,947],{"class":442},"sudo",[437,949,950],{"class":445}," apt",[437,952,446],{"class":445},[437,954,955],{"class":445}," bubblewrap",[437,957,958],{"class":445}," socat",[437,960,961],{"class":445}," gnome-keyring",[437,963,964],{"class":445}," libsecret-tools\n",[355,966,967,968],{},"On a server without a desktop, create the keyring's «login» collection, as the user that will run the agent:",[428,969,971],{"className":430,"code":970,"language":432,"meta":433,"style":433},"pkill -u \"$(id -u)\" gnome-keyring-d\nprintf '\\n' | gnome-keyring-daemon --unlock --components=secrets --daemonize\n",[373,972,973,995],{"__ignoreMap":433},[437,974,975,978,981,984,987,989,992],{"class":439,"line":13},[437,976,977],{"class":442},"pkill",[437,979,980],{"class":476}," -u",[437,982,983],{"class":445}," \"$(",[437,985,986],{"class":442},"id",[437,988,980],{"class":476},[437,990,991],{"class":445},")\"",[437,993,994],{"class":445}," gnome-keyring-d\n",[437,996,997,1000,1003,1006,1009,1012,1015],{"class":439,"line":19},[437,998,999],{"class":476},"printf",[437,1001,1002],{"class":445}," '\\n'",[437,1004,1005],{"class":472}," |",[437,1007,1008],{"class":442}," gnome-keyring-daemon",[437,1010,1011],{"class":476}," --unlock",[437,1013,1014],{"class":476}," --components=secrets",[437,1016,1017],{"class":476}," --daemonize\n",[355,1019,1020,1021,1023,1024],{},"On Ubuntu 24.04 and newer, allow once the isolation ",[373,1022,933],{}," needs:",[428,1025,1027],{"className":430,"code":1026,"language":432,"meta":433,"style":433},"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",[373,1028,1029,1051,1056,1061,1065,1070,1075,1080,1085,1090],{"__ignoreMap":433},[437,1030,1031,1033,1036,1039,1042,1045,1048],{"class":439,"line":13},[437,1032,947],{"class":442},[437,1034,1035],{"class":445}," tee",[437,1037,1038],{"class":445}," \u002Fetc\u002Fapparmor.d\u002Fbwrap",[437,1040,1041],{"class":472}," >",[437,1043,1044],{"class":445},"\u002Fdev\u002Fnull",[437,1046,1047],{"class":472}," \u003C\u003C",[437,1049,1050],{"class":445},"'PROFILE'\n",[437,1052,1053],{"class":439,"line":19},[437,1054,1055],{"class":445},"abi \u003Cabi\u002F4.0>,\n",[437,1057,1058],{"class":439,"line":24},[437,1059,1060],{"class":445},"include \u003Ctunables\u002Fglobal>\n",[437,1062,1063],{"class":439,"line":29},[437,1064,496],{"emptyLinePlaceholder":495},[437,1066,1067],{"class":439,"line":34},[437,1068,1069],{"class":445},"profile bwrap \u002Fusr\u002Fbin\u002Fbwrap flags=(unconfined) {\n",[437,1071,1072],{"class":439,"line":39},[437,1073,1074],{"class":445},"  userns,\n",[437,1076,1077],{"class":439,"line":45},[437,1078,1079],{"class":445},"  include if exists \u003Clocal\u002Fbwrap>\n",[437,1081,1082],{"class":439,"line":56},[437,1083,1084],{"class":445},"}\n",[437,1086,1087],{"class":439,"line":64},[437,1088,1089],{"class":445},"PROFILE\n",[437,1091,1092,1094,1097,1100],{"class":439,"line":73},[437,1093,947],{"class":442},[437,1095,1096],{"class":445}," apparmor_parser",[437,1098,1099],{"class":476}," -r",[437,1101,1102],{"class":445}," \u002Fetc\u002Fapparmor.d\u002Fbwrap\n",[355,1104,1105,1106,384],{},"In CloseYourIt open ",[365,1107,1108],{},"Automator → Connect a machine",[355,1110,1111],{},"Copy the command and run it on the machine.",[355,1113,1114,1115,1118],{},"Run ",[373,1116,1117],{},"automator doctor"," on the machine: it says what is still missing.",[345,1120,1121,1122,1125],{},"On a machine with Codex only, also set ",[373,1123,1124],{},"AUTOMATOR_WORK_ENGINE=codex"," in the service environment.",[386,1127,1129],{"id":1128},"_8-give-the-machine-the-go-ahead","8. Give the machine the go-ahead",[345,1131,1132],{},"A newly connected machine does not work until a person allows it.",[391,1134,1135,1141,1146],{},[355,1136,600,1137,1140],{},[365,1138,1139],{},"Agents"," and pick the machine.",[355,1142,621,1143,384],{},[365,1144,1145],{},"Certify host",[355,1147,1148,1149,1152,1153,697,1156,1159],{},"In ",[365,1150,1151],{},"Details and settings"," check ",[365,1154,1155],{},"Who does the work",[365,1157,1158],{},"Who reviews the work",". With two engines, let the other one review.",[386,1161,1163],{"id":1162},"_9-let-an-agent-take-the-ticket","9. Let an agent take the ticket",[391,1165,1166,1169],{},[355,1167,1168],{},"Open the ticket from step 5.",[355,1170,901,1171,1173,1174,1177,1178,384],{},[365,1172,277],{}," box, under ",[365,1175,1176],{},"Who works it",", pick ",[365,1179,1139],{},[345,1181,1182,1183,1186],{},"From the terminal: ",[373,1184,1185],{},"cyi tickets eligibility \u003Ccode> --project web --allow",". The agent waits if the ticket depends on unfinished work or has an open question that blocks it.",[386,1188,1190],{"id":1189},"_10-approve-the-plan","10. Approve the plan",[345,1192,1193,1194,1197,1198,1201],{},"The agent writes a plan first: what changes and why, the risks, and when the work can be called done. The plan is decided by the ",[365,1195,1196],{},"Project CTO"," or, if the project has none, by the ",[365,1199,1200],{},"Organization CTO",": set one of the two if they are empty.",[391,1203,1204,1217,1223],{},[355,1205,600,1206,1209,1210,1213,1214,384],{},[365,1207,1208],{},"Approvals",", or press ",[373,1211,1212],{},"g"," then ",[373,1215,1216],{},"a",[355,1218,621,1219,1222],{},[365,1220,1221],{},"Review"," on the plan.",[355,1224,621,1225,1228,1229,1232],{},[365,1226,1227],{},"Accept the plan",". If something is wrong, ",[365,1230,1231],{},"Reject"," with a reason: a new version comes back.",[386,1234,1236],{"id":1235},"_11-accept-the-work","11. Accept the work",[345,1238,1239],{},"The agent writes the fix and hands over a work report: what it did, which files changed, which tests ran.",[352,1241,1242,1245],{},[355,1243,1244],{},"If the automatic code checks pass and the reviewer accepts it, the work moves on by itself.",[355,1246,1247,1248,1250,1251,921,1254,384],{},"Otherwise it waits in ",[365,1249,1208],{}," for ",[365,1252,1253],{},"Accept the work",[365,1255,1231],{},[345,1257,1258],{},"After staging the release waits 2 hours. If no new error shows up on staging, it goes to production by itself.",[386,1260,1262],{"id":1261},"_12-close-the-error","12. Close the error",[345,1264,1265,1266,1269,1270,1273,1274,1277],{},"When the fix is in production, open the error, press ",[365,1267,1268],{},"Resolve"," and write the ",[365,1271,1272],{},"Cause"," and the ",[365,1275,1276],{},"Fix",". If the same error comes back from an up-to-date release, CloseYourIt reopens it by itself.",[1279,1280,1281],"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":433,"searchDepth":19,"depth":19,"links":1283},[1284,1285,1286,1287,1288,1289,1290,1291,1292,1293,1294,1295],{"id":388,"depth":19,"text":389},{"id":425,"depth":19,"text":426},{"id":452,"depth":19,"text":453},{"id":568,"depth":19,"text":569},{"id":606,"depth":19,"text":607},{"id":633,"depth":19,"text":634},{"id":913,"depth":19,"text":914},{"id":1128,"depth":19,"text":1129},{"id":1162,"depth":19,"text":1163},{"id":1189,"depth":19,"text":1190},{"id":1235,"depth":19,"text":1236},{"id":1261,"depth":19,"text":1262},"md",{},{"title":181,"description":182},"docs\u002Frecipe-error-to-agent","i1nJ6HlhrdmMIysl3R0SScNlTxWsfR3QkRKvmgJ2omg",1794441702251]