[{"data":1,"prerenderedAt":49},["ShallowReactive",2],{"doc:en:updates":3},{"title":4,"lede":5,"html":6,"headings":7},"Updates","Escouade updates itself from GitHub releases: it downloads in the background, then installs at the restart you choose or, if you allow it, by itself when it is at rest. This page explains how, system by system, and where to read what’s new.","\u003Ch2 id=\"how-it-works\">How it works\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Escouade looks for a new version shortly after it starts, then five minutes after each check ends. It reads the \u003Ccode class=\"key\">latest.json\u003C\u002Fcode> file of the latest release published on \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fguillaume-gagnaire\u002Fescouade\u002Freleases\" rel=\"noopener\">GitHub\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>When a newer version exists, it downloads it right away, without asking, and checks its signature. During the download, the status bar shows “Update 1.8.0…” (with the version number).\u003C\u002Fli>\n\u003Cli>Once downloaded, the update waits: the status bar shows “Update 1.8.0 ready · Restart”. It installs when you restart the app, when the app restarts by itself, or when you quit it.\u003C\u002Fli>\n\u003Cli>Installation happens without an installer window. The proxy and certificate verification set in Settings › Network apply to the checks and downloads too.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"installing-an-update\">Installing an update\u003C\u002Fh2>\n\u003Ch3 id=\"restart-yourself\">Restart yourself\u003C\u002Fh3>\n\u003Cp>Clicking “Update 1.8.0 ready · Restart” opens the “Escouade 1.8.0 is ready” window, which shows the release notes. It has two buttons: “Later” and “Restart now”.\u003C\u002Fp>\n\u003Cp>The window warns you about what a restart cuts off:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Editor files aren’t saved: “Save your files first”. The “Restart now” button stays disabled as long as some remain.\u003C\u002Fli>\n\u003Cli>Agents are working or waiting for your answer: their current turn is interrupted. A ticket agent picks up again by itself; the others wait for your next message.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Escouade stops cleanly before installing: the agents’ processes and the terminals stop, and each agent’s session and the app’s state are saved. After the restart, the window comes back as it was (in front, behind another window, minimized, or closed to the notification area), and a message in the window says “Escouade 1.8.0 is installed.”, with a “See what’s new” button.\u003C\u002Fp>\n\u003Ch3 id=\"restart-automatically\">Restart automatically\u003C\u002Fh3>\n\u003Cp>The “Install updates automatically” setting (Settings › About, on by default) lets Escouade restart by itself: “Escouade restarts itself when no agent is working and everything is saved.”\u003C\u002Fp>\n\u003Cp>The app is at rest when none of this is true:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>An agent is working or waiting for your answer (a question or a permission).\u003C\u002Fli>\n\u003Cli>A worktree is being set up.\u003C\u002Fli>\n\u003Cli>A ticket is being approved (merge, pull request, push), or other work is under way outside an agent’s turn, for example a ticket starting or a merge you asked for by hand.\u003C\u002Fli>\n\u003Cli>A launch command or a step of a test launch is running, or a test launch is being prepared.\u003C\u002Fli>\n\u003Cli>A built-in terminal has received or displayed something in the last five minutes. A terminal that has been silent longer doesn’t count.\u003C\u002Fli>\n\u003Cli>The editor holds unsaved files.\u003C\u002Fli>\n\u003Cli>A dialog (settings, commit…) is open.\u003C\u002Fli>\n\u003Cli>You have touched the keyboard or the mouse in the window in the last five minutes. This only counts if the window is on screen: minimized or closed to the notification area, it no longer holds the restart back.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>When the app is at rest, Escouade warns you thirty seconds before restarting: the status bar shows “Restarting in 30 s” with a “Later” button, and a system notification says “Escouade is restarting to update”, whatever the “System notifications” setting says (on Windows, with the same “Later” button; on Linux, only the status bar warns you). If the app stops being at rest during that countdown (an agent gets back to work, you touch the keyboard), the restart is canceled and waits for the next rest. “Later” pushes it back by thirty minutes.\u003C\u002Fp>\n\u003Ch3 id=\"quitting-the-app\">Quitting the app\u003C\u002Fh3>\n\u003Cp>Closing the window doesn’t quit Escouade: it stays in the notification area. If you quit it (“Quit” in the menu of its icon, or \u003Ccode class=\"key\">⌘Q\u003C\u002Fcode> on macOS) while an update is ready, the update installs and the app stays closed.\u003C\u002Fp>\n\u003Ch3 id=\"if-the-installation-fails\">If the installation fails\u003C\u002Fh3>\n\u003Cp>The app stays on the old version and says so: “The update to 1.8.0 couldn’t be installed.” with a “Retry” button, which reopens the update window. It no longer restarts by itself for that version; it tries again on request, or when you quit the app.\u003C\u002Fp>\n\u003Ch2 id=\"checking-by-hand\">Checking by hand\u003C\u002Fh2>\n\u003Cp>Settings › About shows the installed version (“Escouade 1.7.5”, for example) and a “Check for updates” button. The answer is “No update available.”, or the update appears in the status bar. A failure is reported as it is: “Couldn’t check for updates” or “Couldn’t download the update”, followed by what the server answered. Behind a proxy or a corporate certificate, see \u003Ca href=\"\u002Fen\u002Fdocs\u002Ftroubleshooting\u002F\">troubleshooting\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"by-system\">By system\u003C\u002Fh2>\n\u003Ch3 id=\"windows\">Windows\u003C\u002Fh3>\n\u003Cp>The installer runs without a window, and Escouade restarts on the new version.\u003C\u002Fp>\n\u003Ch3 id=\"macos\">macOS\u003C\u002Fh3>\n\u003Cp>The app is signed with an Apple Developer ID certificate and notarized by Apple (since 1.5.4): macOS opens it without asking for permission. The update replaces the app in place.\u003C\u002Fp>\n\u003Cp>The automatic restart, and the installation when the app quits, require that your user can modify Escouade.app and the folder that holds it. Otherwise the update waits for you to click “Restart now”, and macOS may ask for an administrator password.\u003C\u002Fp>\n\u003Ch3 id=\"linux\">Linux\u003C\u002Fh3>\n\u003Cp>The built-in update replaces the \u003Ccode class=\"key\">AppImage\u003C\u002Fcode> you launched. The \u003Ccode class=\"key\">.deb\u003C\u002Fcode> (Debian, Ubuntu) is first installed with \u003Ccode>sudo apt install .\u002FEscouade_*_amd64.deb\u003C\u002Fcode>; after that, the built-in update downloads the release’s new \u003Ccode class=\"key\">.deb\u003C\u002Fcode> and installs it with \u003Ccode class=\"key\">dpkg\u003C\u002Fcode>: the system then asks for your administrator password (through \u003Ccode class=\"key\">pkexec\u003C\u002Fcode>, otherwise through \u003Ccode class=\"key\">sudo\u003C\u002Fcode>).\u003C\u002Fp>\n\u003Ch2 id=\"from-claude-code-manager-to-escouade\">From Claude Code Manager to Escouade\u003C\u002Fh2>\n\u003Cp>Escouade used to be called “Claude Code Manager”. The update that renamed it replaces the old installation and keeps your settings, projects, and conversations. On Windows, the installer first removes the old installation, keeping your data, then creates Escouade’s shortcuts. The data folder changes name: see \u003Ca href=\"\u002Fen\u002Fdocs\u002Fdata\u002F\">local data\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"reading-what-changed\">Reading what changed\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>In the app.\u003C\u002Fstrong> The window of a ready update shows its notes. After the installation, “See what’s new” opens “What’s new in Escouade 1.8.0”.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>On GitHub.\u003C\u002Fstrong> The \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fguillaume-gagnaire\u002Fescouade\u002Fblob\u002Fmain\u002FCHANGELOG.md\" rel=\"noopener\">changelog\u003C\u002Fa> lists, version by version, what changes. The notes of each release reuse that version’s section.\u003C\u002Fli>\n\u003C\u002Ful>\n",[8,12,15,19,22,25,28,31,34,37,40,43,46],{"id":9,"text":10,"depth":11},"how-it-works","How it works",2,{"id":13,"text":14,"depth":11},"installing-an-update","Installing an update",{"id":16,"text":17,"depth":18},"restart-yourself","Restart yourself",3,{"id":20,"text":21,"depth":18},"restart-automatically","Restart automatically",{"id":23,"text":24,"depth":18},"quitting-the-app","Quitting the app",{"id":26,"text":27,"depth":18},"if-the-installation-fails","If the installation fails",{"id":29,"text":30,"depth":11},"checking-by-hand","Checking by hand",{"id":32,"text":33,"depth":11},"by-system","By system",{"id":35,"text":36,"depth":18},"windows","Windows",{"id":38,"text":39,"depth":18},"macos","macOS",{"id":41,"text":42,"depth":18},"linux","Linux",{"id":44,"text":45,"depth":11},"from-claude-code-manager-to-escouade","From Claude Code Manager to Escouade",{"id":47,"text":48,"depth":11},"reading-what-changed","Reading what changed",1791926756735]