[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ECT12C9Q60KVYC7T5HQQVH":3,"skill-same:01M7ECT12C9Q60KVYC7T5HQQVH":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M7ECT12C9Q60KVYC7T5HQQVH","hermes-desktop-launch",null,"jonahthan433\u002FCortexOS","jonahthan433","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211465495?v=4","01M7ECH9HPHGA89DCXHHJBTS3C","jonah.ai","01M7ECH9JCEM45DZMWPT7148S1",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fhermes-ops\u002Fhermes-desktop-launch\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# hermes-desktop-launch\n\n# Hermes Desktop launch repair\n\n## Trigger\nUser reports the Hermes Desktop GUI won't start. Symptom strings:\n- `Missing X server or $DISPLAY` + `The platform failed to initialize. Exiting.`\n- `xinit: unable to run server \"\u002Fusr\u002Fbin\u002FX\": No such file or directory`\n- Electron\u002FChromium Ozone platform init failure on Linux.\n\nOr: user reports `hermes update` keeps rebuilding\u002Fcompiling the desktop app\non a server that has no GUI and never runs `hermes desktop` — see the\nheadless section below instead of the display fixes.\n\n## Root cause (read first — the launcher is NOT broken)\n`hermes_cli\u002Fmain.py` is fine. It inherits the user's `DISPLAY`\u002F`WAYLAND_DISPLAY`\nand appends `desktop.electron_flags` to the Electron launch command\n(main.py ~8073). The failure is **environmental**: Electron's default ozone\nbackend is **X11**, which needs an X display server. On a **Wayland session**\n(Fedora KDE 6 Plasma defaults to Wayland) there is no X11 `:0` — so\n`DISPLAY=:0` is inert (nothing listens there) and Electron dies.\n`startx` fails when **Xorg isn't installed** (`\u002Fusr\u002Fbin\u002FX` missing).\n\nThe `chrome-sandbox ✗` line printed before launch is **non-fatal** — the app\nstill launches. Do NOT chase it.\n\n## Diagnose (run on the user's machine — the agent cannot reach the laptop)\n```bash\necho \"type=$XDG_SESSION_TYPE DISPLAY=$DISPLAY WAYLAND_DISPLAY=$WAYLAND_DISPLAY\"\nls -l $XDG_RUNTIME_DIR\u002Fwayland-* 2>\u002Fdev\u002Fnull\nwhich Xorg Xvfb 2>\u002Fdev\u002Fnull\n```\n- `XDG_SESSION_TYPE=wayland` + a `wayland-*` socket → Fix A.\n- `XDG_SESSION_TYPE=tty` (no socket) → user is at a text console; start the GUI:\n  `sudo systemctl start sddm` then log into Plasma, then `hermes desktop`.\n- `which Xorg` empty → Xorg missing; install it or use Fix B (Xvfb).\n\n## Fix A — Wayland (most common on Fedora KDE)\nPersistent, via the existing config knob (no launcher patch needed):\n```bash\nhermes config set desktop.electron_flags '[\"--ozone-platform=wayland\"]'\nhermes desktop\n```\nOne-shot env equivalent:\n```bash\nexport ELECTRON_OZONE_PLATFORM_HINT=wayland\nhermes desktop\n```\n\n## Fix B — headless \u002F no real display (VNC, screenshot, CI)\n```bash\nsudo dnf install -y xorg-x11-server-Xvfb        # Fedora\nXvfb :99 -screen 0 1280x800x24 & sleep 2\nDISPLAY=:99 hermes desktop\n```\nDebian\u002FUbuntu: `sudo apt-get install -y xvfb`.\n\n## Notes\n- `desktop.electron_flags` default is `[]` (config_defaults.py ~3568); a single\n  string is also accepted and shell-split. Other useful values:\n  `[\"--ozone-platform=x11\"]` on headless\u002FVM X11 hosts, or GPU workaround flags.\n- `desktop.disable_gpu` (`\"auto\"`\u002F`true`\u002F`false`) bridges to\n  `HERMES_DESKTOP_DISABLE_GPU`; `\"auto\"` already disables GPU only on detected\n  remote displays (SSH\u002FVNC\u002FRDP). Rarely the cause of a launch failure.\n- The agent runs in a remote container (CT103) and cannot reach the user's\n  laptop; these commands are for the user to paste locally. Ask the user for\n  diagnostic output rather than guessing.\n\n## Pitfalls\n- Setting `DISPLAY=:0` without an X server only hides the real problem.\n- Don't reinstall\u002Frebuild the desktop app for a display error — the build is\n  fine; the launch env is the issue.\n- Don't treat `chrome-sandbox ✗` as the blocker; it is non-fatal.\n\nSee references\u002Fwayland-x11-fix.md for the verbatim error log and the\nmain.py flag-append excerpt used to confirm root cause.\n\n## Headless server: stop `hermes update` from rebuilding Desktop\n\n### Root cause\n`hermes_cli\u002Fupdate_cmd_deps.py::_rebuild_desktop_after_update` treats Desktop\nas \"installed\" — and therefore rebuilds it on every `hermes update` — if\n**any** of these exist, even on a box that has never run a GUI:\n- a packaged Electron executable, or `apps\u002Fdesktop\u002Fdist\u002Findex.html`\n  (`_desktop_app_present`)\n- `$HERMES_HOME\u002Fdesktop-build-stamp.json` (survives on purpose so a swap\n  that lost artifacts mid-update still gets rebuilt — but it also means a\n  stray stamp from one manual\u002Faccidental build keeps triggering rebuilds\n  forever after)\n\nOn a headless server this is pure waste: an Electron\u002Fnpm build burns\nminutes and hundreds of MB (`node_modules` + `release\u002F` alone commonly\n300-350MB each) every update, for an app that will never be launched.\n\n### Fix — delete the artifacts once\n```bash\nrm -f ~\u002F.hermes\u002Fdesktop-build-stamp.json\nrm -rf \u003Crepo>\u002Fapps\u002Fdesktop\u002Fdist \u003Crepo>\u002Fapps\u002Fdesktop\u002Frelease \u003Crepo>\u002Fapps\u002Fdesktop\u002Fnode_modules\n```\nWith all three signals gone, the next `hermes update` skips the Desktop\nrebuild stage entirely. No config flag exists to opt out while artifacts are\npresent — the presence check IS the trigger, so removal is the only lever.\n\n### Pitfalls\n- A single `hermes update` run that started **while** any artifact still\n  existed captures `had_desktop_app_before_update=True` for that run and will\n  rebuild one more time even after you clean up mid-run — clean up, then let\n  the *next* update run confirm it stays skipped, don't judge from the run\n  you cleaned up during.\n- Don't chase this as a code bug — the check is intentional (protects users\n  who lost Desktop artifacts mid-swap). The fix on a headless box is deleting\n  the leftover build, not patching the updater.\n",{},"main","38b32c99e7ed0b8e215d638e92cfa452c1ec3079","skills\u002Fimported\u002Fhermes-ops\u002Fhermes-desktop-launch","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS","https:\u002F\u002Fgithub.com\u002Fjonahthan433","AI Consultant","2026-10-24 05:13:39",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add jonahthan433\u002FCortexOS --skill hermes-desktop-launch",{"tool":35,"command":36},"bunx","bunx skills add jonahthan433\u002FCortexOS --skill hermes-desktop-launch",{"tool":38,"command":39},"pnpm","pnpm dlx skills add jonahthan433\u002FCortexOS --skill hermes-desktop-launch","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fhermes-ops\u002Fhermes-desktop-launch\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"skill.json","REFERENCE","参考文档",429,"https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fhermes-ops\u002Fhermes-desktop-launch\u002Fskill.json",[50,56,62,68,74,80],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M7EDQZDQX3Q8Y7GCQX6KN9V7","opportunity-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fsales\u002Fopportunity-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M7EDQYA0V9Y99VKBREJJ3MRT","morning-intel","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fmorning-intel\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EDQVX1JVY0B6PDHKKGM19G","decision-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fdecision-brief\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7EDQV1GENZAC2SZSD8KZ3GM","weekly-review","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fweekly-review\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7EDQT2KETJ1Y3CGVN9EKW2J","system-health","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fsystem-health\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EDQQN2JK3XPWMS1M4T0F3K","backup-restore","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fbackup-restore\u002FSKILL.md",[],[]]