Let an AI coding agent open a file in a GUI editor like Kate or VS Code without freezing its own session.
Install launch-gui as a Hermes Agent skill so GUI launching works automatically inside agent sessions.
Add the technique to Claude Code, Codex, or OpenClaw instructions to unblock GUI app launches.
| jimdawdy-hub/launch-gui | s-sahoo/phd-thesis | jimmc414/fable2opus_handoff_kit | |
|---|---|---|---|
| Stars | 3 | 4 | 1 |
| Language | None | None | None |
| Setup difficulty | easy | — | moderate |
| Complexity | 1/5 | 1/5 | 3/5 |
| Audience | developer | researcher | developer |
Figures from each repo's GitHub metadata at analysis time.
Linux desktop (X11 or Wayland) required, SSH sessions need X forwarding.
launch-gui solves a specific annoyance for people running AI coding agents in a terminal: those agent tools usually block normal shell backgrounding tricks like the trailing ampersand, nohup, disown, or setsid, so a command meant to open a graphical app in the background either gets rejected outright or hangs the whole session. This project documents and packages the fix for that problem, working with Hermes Agent, Claude Code, Codex, and OpenClaw. The fix itself is small: instead of trying to background a process through the shell, you use Python's subprocess.Popen with start_new_session set to true, called through whichever code execution tool your agent provides. This fully detaches the new process from the agent's own session, so a graphical app like a text editor or file browser opens on screen immediately while the agent gets its terminal prompt back right away, without waiting for that app to close. For Hermes Agent users, the project can be installed as a skill directly through Hermes's own skill installer, or by cloning the repository into the Hermes skills folder. For Claude Code, Codex, or OpenClaw, you simply copy the included SKILL.md file into your agent's instruction directory, or just remember the one line technique directly, since it does not require any special installation. A table of already tested applications is included, covering common Linux desktop tools such as Kate, Dolphin, Konsole, Firefox, VS Code, Okular, Gwenview, gedit, and Nautilus, though the technique works with any application that can be launched from a plain command line. The README also lists a few practical pitfalls: the DISPLAY environment variable must be set correctly for the app to appear, Wayland desktops need the WAYLAND_DISPLAY and XDG_RUNTIME_DIR variables set as well, connecting over SSH requires X forwarding or a local session, and if Firefox is already running, the command will simply open a new tab and then exit right away, which is expected behavior rather than a failure. The project is released under the MIT license.
A small technique and skill package that lets AI coding agents launch Linux GUI apps in the background without their terminal tools blocking or hanging.
Mainly None. The stack also includes Python, Shell.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.