claude-desktop-debian

Claude Desktop for Debian-based Linux distributions

17 articles 3.5k View on GitHub ↗
17 articles
Self-Referential .mcpb-cache Symlink Bug and bwrap Handling in Claude Desktop Debian

Fix the self-referential .mcpb-cache symlink bug in Claude Desktop Debian. Learn how Bubblewrap handles it by detecting and removing the symlink before sandbox bind-mounts.

internals
Apr 19, 2026
How to Read Cowork Daemon Logs and Troubleshoot Startup Failures in Claude Desktop

Troubleshoot Claude Desktop Cowork daemon startup failures by examining the cowork_vm_daemon.log. Learn to grep logs for errors and diagnose initialization crashes or system kills efficiently.

how-to-guide
Apr 19, 2026
Protocol Used by Linux cowork-vm-service: Unix Socket & JSON Framing Guide

Discover the Linux cowork-vm-service protocol. Learn how it uses Unix sockets and JSON framing for efficient inter-process communication on Linux systems. Understand this key aspect of the claude-desktop-debian repository.

deep-dive
Apr 19, 2026
Daemon Auto-Spawn Mechanism for Cowork Sessions in Claude Desktop

Automatically relaunch the cowork vm service with the daemon auto-spawn mechanism. This feature intercepts ECONNREFUSED errors and forks a new process. Ensure seamless Cowork sessions in Claude Desktop.

internals
Apr 19, 2026
Guest-Path Translation for Tool Permissions in Claude Desktop Cowork Mode

Learn how Claude Desktop Debian uses guest-path translation to secure tool permissions and prevent directory-traversal attacks in Cowork Mode.

internals
Apr 19, 2026
KDE Quick Window Blur/Hide Patch for Focus Issues in Claude Desktop on Linux

Fix KDE Plasma focus issues with Claude Desktop using a blur/hide patch. This patch ensures the quick-entry window releases focus, allowing the main window to appear seamlessly.

fix
Apr 19, 2026
How to Patch Linux Claude Code Binary Support into the Claude Desktop Electron App

Enable Linux Claude Code binary support in the Claude desktop app with platform detection patches and a Nodejs service daemon. Learn how to patch Electron for sandboxed execution.

how-to-guide
Apr 19, 2026
AppImage Sandbox Restrictions and Isolation Alternatives for Claude Desktop

Explore AppImage sandbox restrictions for Claude Desktop and discover isolation alternatives like native packages, Bubblewrap containers, or VM backends to enhance security.

deep-dive
Apr 19, 2026
Global Hotkey Not Working in Native Wayland Mode: A Technical Fix for Claude Desktop

Fix the global hotkey not working in Wayland for Claude Desktop. Learn why the Ctrl Alt Space shortcut fails and how to enable it.

how-to-guide
Apr 19, 2026
Dependencies for Building .deb, .rpm, and AppImage Packages for Claude Desktop

Learn the essential dependencies for building .deb, .rpm, and AppImage packages for Claude Desktop. Master standard Linux packaging tools like dpkg-dev, rpm-build, and appimagetool.

dependencies
Apr 19, 2026
How to Build Claude Desktop on Linux Using a Local Windows Installer

Build Claude Desktop on Linux easily using a local Windows installer. Follow our guide to extract the Electron app and package it for Debian, RPM, or AppImage.

how-to-guide
Apr 19, 2026
Fix Claude Desktop OAuth Token Cache 401 Authentication Errors

Resolve Claude Desktop OAuth token cache 401 authentication errors by deleting the stale oauth token entry from config json. Get Claude Desktop working again.

how-to-guide
Apr 19, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →