linux

Diagnose and patch Linux compatibility issues in claude-desktop-bin.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/patrickjaja/claude-desktop-bin --skill linux-patrickjaja
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linux
Source: https://github.com/patrickjaja/claude-desktop-bin/tree/main/.claude/skills/linux
Command: npx skills add https://github.com/patrickjaja/claude-desktop-bin --skill linux-patrickjaja

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides the Linux-specific guidance needed to keep claude-desktop-bin running correctly across distros, session types, and compositor quirks.

Core Features & Use Cases

  • Linux compatibility reference for patching the upstream Claude Desktop msix bundle.
  • Guidance for session detection, input injection, screenshots, multi-profile identity, and glibc floor decisions.
  • Useful when fixing Wayland, X11, XWayland, GNOME, KDE, wlroots, distro packaging, or Computer Use regressions.

Quick Start

Use the linux skill to assess the Linux compatibility impact of the requested claude-desktop-bin change and suggest the correct patching path.

Frequently Asked Questions about linux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I patch claude-desktop-bin for Linux compatibility issues?

Patching claude-desktop-bin for Linux compatibility involves modifying upstream patch bundles, JavaScript executors, and launcher logic to resolve session detection, input, and screenshot backend issues across distros and compositors.

Does Claude Desktop work on Wayland and X11 compositors?

Claude Desktop can work on Wayland and X11 by applying compositor-specific fallbacks. The linux skill provides guidance for handling XWayland, GNOME, KDE, and wlroots session detection to prevent Computer Use regressions.

Why does Claude Desktop fail to capture screenshots or inject input on my Linux distro?

Screenshot and input injection failures on Linux often stem from unpatched Electron backends or incorrect session detection. Diagnosing these requires checking compositor compatibility and applying necessary JavaScript executor modifications.

How do I fix glibc floor and multi-profile identity issues in Electron packaging?

Fixing glibc floor and multi-profile identity issues requires careful adjustment of Linux-only Electron packaging logic. This ensures proper session detection and profile behavior without introducing macOS or Windows specific code.

What are the limitations of patching upstream msix bundles for Linux?

Patching upstream msix bundles for Linux is limited to Linux-only scenarios and requires validation against distro and compositor matrices. It does not support adding macOS or Windows code and needs careful modification of existing patch bundles.

Can I use this approach to fix GNOME and KDE specific regressions in Claude Desktop?

Yes, this approach fixes GNOME and KDE specific regressions by providing compositor-specific fallbacks and session detection guidance. It validates changes against compositor matrices to ensure stable Electron packaging behavior.