Skip to content

Add the Claude desktop app to Install > AI - #10755

Merged
spencerbull merged 2 commits into
omacom:quattrofrom
spencerbull:add-claude-desktop-ai-menu
Sep 11, 2026
Merged

spencerbull merged 2 commits into
omacom:quattrofrom
spencerbull:add-claude-desktop-ai-menu

Conversation

@spencerbull

@spencerbull spencerbull commented Sep 8, 2026 •

Copy link
Copy Markdown
Contributor

Anthropic's Claude desktop app has been in beta on Linux since June, and Omarchy now carries it in its package repo as claude-desktop (omacom/omarchy-pkgs#348, repacked from Anthropic's own Debian repository the way openai-codex-desktop repacks ChatGPT's). This surfaces it under Install > AI and Remove > AI, mirroring the ChatGPT Desktop integration piece for piece.

  • bin/omarchy-install-ai-claude / bin/omarchy-remove-ai-claude follow the chatgpt pair's shape, under set -euo pipefail like the Perplexity and Hermes removers — an unset HOME is an error rather than a pair of rm -rf paths rooted at /. The remover quits the app first — Electron rewrites ~/.config/Claude for as long as it runs, so a removal that leaves it open watches the directory come straight back — then deletes the desktop app's Electron state (~/.config/Claude, ~/.cache/Claude) and deliberately keeps ~/.claude, ~/.claude.json, and ~/.cache/claude-cli-nodejs — those belong to the Claude Code CLI, which ships in a different package that survives this one. One honest note: on a real install, everything the app writes nests inside ~/.config/Claude; ~/.cache/Claude hasn't been observed in practice and the line is defensive parity with the ChatGPT remover (a no-op when absent), in case a future Electron splits sessionData out.
  • The menu entries gate on omarchy-pkg-present claude-desktop, alphabetical between ChatGPT and Dictation, with a real Claude mark: the Simple Icons starburst added to the omarchy icon font at U+E90E via bin/omarchy-dev-font, provenance recorded in the font README, per the icon-font skill ("a generic robot for four different AI apps is the case that justifies a real mark"). Until the font reaches desktops through an omarchy-settings release, the entry renders without an icon.
  • test/shell.d/remove-ai-test.sh covers the remover the same way it covers ChatGPT's: config and caches deleted, CLI state preserved. test/shell.d/menu-test.sh's font charset pin moves to e900-e90e.
  • manual/17-ai.md adds the app to the graphical-apps list.

Verified: the remove-ai and menu suites pass (30/30 asserts and the font assertions respectively); the config-dir semantics were checked against a live claude-desktop install rather than assumed. Installing depends on omacom/omarchy-pkgs#348 landing so omarchy-pkg-add claude-desktop can resolve.

@spencerbull

Copy link
Copy Markdown
Contributor Author

Reviewed by Fable 5 in T3 Code, with an independent codex second opinion at xhigh reasoning; every claim below was verified against the source or a live install before being written down. Worker-VM verification could not run from the reviewing machine (no hypervisor access), so this is static review, the shell suites, and checks against a live claude-desktop install on a real Omarchy desktop; the icon-font skill's "confirm it in the running menu" step remains undone, which the body already flags as blocked on an omarchy-settings release regardless.

Checked and found clean:

  • Full shell suite at the PR head: 232 of 235 files pass, and the three failures (config, snapper, unowned-system-paths) fail identically on clean quattro on the same machine — environmental, not this PR.
  • The new assertions are not vacuous: mutating the remover to delete nothing fails "deletes the desktop app's config and caches", and mutating it to also delete ~/.claude fails "keeps the Claude Code CLI's state". Codex confirmed the harness runs the real remover under a real temporary HOME (agreement from the same machine, so independence is not guaranteed).
  • Both menu entries carry exactly U+E90E at the byte level with iconFont:"omarchy", gating and ordering match their siblings, and the rendered glyph row shows a clean single-path starburst per the icon-font skill's verification step.
  • Against the live install: the package ships /usr/bin/claude-desktop, matching the install script; ~/.config/Claude exists while ~/.cache/Claude does not, matching the body's note; the three CLI paths the remover spares are exactly where Claude Code keeps its state.

Needs to change before merge:

  1. The font conflict hides a revert. quattro regenerated the Hermes glyph (U+E90A) inside omarchy.ttf after this branched (1cb960a), so resolving the conflict by keeping this branch's binary silently restores the old caduceus mark — both fonts were rendered and the difference is visible. The rebase needs the font rebuilt from quattro's ttf with omarchy dev font add claude https://simpleicons.org/icons/claude.svg (U+E90E is still the next free codepoint there), not either side of the conflict taken whole.
  2. set -euo pipefail in both new scripts, per the Perplexity and Hermes removers — the Hermes remover documents the exact hazard: "-u so an unset HOME is an error rather than a set of rm -rf paths rooted at /." The new remover copies the older ChatGPT shape, where an unset HOME turns the deletion targets into /.config/Claude and /.cache/Claude. This finding is codex's and stands on its own terms.
  3. Landing order: Add claude-desktop, Anthropic's Linux desktop beta omarchy-pkgs#348 is still open, so merging this first ships an Install entry whose action dies at omarchy-pkg-add. The body names the dependency; it needs to land second. Related, for Combine plymouth and login installers #348 rather than here: the current package build ships /usr/bin/virtiofsd, colliding with the virtiofsd package — on a machine carrying both, pacman reports the file owned by both. That bundled binary likely belongs under /usr/lib/claude-desktop.

Codex findings rejected after verification:

  • "First launch can fall back to Electron's plaintext basic_text credential store on an unrecognized desktop" — refuted on the exact target platform: a live Omarchy/Hyprland install holds a "Claude Safe Storage" entry in gnome-keyring, its cookie store contains 22 keyring-backed v11 values and zero plaintext-era v10, and the app ships its own password-store preflight. No launch flag is needed here.
  • "The hard-coded paths ignore $XDG_CONFIG_HOME" — every remover in the repo hard-codes ~/.config, including the ChatGPT pair this mirrors; Omarchy defines the environment it runs in.
  • "Removal deletes user-created data (claude_desktop_config.json MCP definitions, local session records) without confirmation" — true, but disclosed in the command's own summary and exact parity with the ChatGPT remover, and chats live server-side. Whether Claude deserves a Hermes-style ask is maintainer taste, not a defect against the repo's pattern.
  • "The remover does not stop a running app first" — parity with ChatGPT again; the Hermes holder check exists because a runtime executes out of the tree being deleted, which is not the case here.

Waiting on the author for the rebase with the font rebuild and the set tightening, and on omarchy-pkgs#348 for the install path.

🤖 Generated by Fable 5 in T3 Code. Reviewed by Codex XHigh.

Follows the ChatGPT flow: the Install > AI entry runs
omarchy-install-ai-claude in a floating terminal, which installs the
claude-desktop package (Anthropic's Linux desktop beta, repacked from
their Debian repo in omarchy-pkgs) and opens the app. Remove > AI
drops the package along with ~/.config/Claude and ~/.cache/Claude,
the Electron directories the desktop app owns, while keeping
~/.claude, ~/.claude.json, and ~/.cache/claude-cli-nodejs: those
belong to the Claude Code CLI, which ships in its own package and
survives this removal, just as the ChatGPT remover keeps the Codex
CLI.

The menu mark is a new U+E90E glyph in the Omarchy icon font, from
Simple Icons' Claude mark, so it reaches desktops through the next
omarchy-settings release.

Co-Authored-By: Fable 5 <noreply@anthropic.com>
Co-Authored-By: Codex XHigh <noreply@openai.com>
@spencerbull
spencerbull force-pushed the add-claude-desktop-ai-menu branch from 82652c8 to 9d0849f Compare September 10, 2026 03:11
@spencerbull

spencerbull commented Sep 10, 2026 •

Copy link
Copy Markdown
Contributor Author

Updated per the review above; the head is now 9d0849f, rebased onto current quattro.

  • The font was rebuilt rather than conflict-resolved: omarchy dev font add claude ran against quattro's ttf, so the regenerated Hermes portrait at U+E90A survives and Claude lands at U+E90E. Verified by rendering the full glyph row and, per the icon-font skill, in the running menu on a disposable Omarchy VM: Install > AI shows Claude Desktop with the starburst mark between ChatGPT Desktop and Dictation, drawn in the theme foreground, with the Hermes portrait intact beside it.
  • Both scripts now run under set -euo pipefail, with the Hermes remover's comment carrying the reason on the destructive one. Proven directly: with HOME unset the previous shape exited 0 having aimed rm -rf at /.config/Claude, the new one aborts at HOME: unbound variable. The commit credits Codex XHigh, whose finding this was.
  • The full shell suite passes at the new head apart from the same four files that fail identically on clean quattro on the reviewing machine; remove-ai-test.sh and menu-test.sh pass.

The landing order stands as reviewed: omacom/omarchy-pkgs#348 first, then this. The changes here apply the findings of the review above (Fable 5 with codex at xhigh); the delta itself is those findings, not new design.

Visual evidence — the menu on the worker, rebuilt font installed:

Install > AI on a disposable Omarchy VM: Claude Desktop with the starburst mark between ChatGPT Desktop and Dictation, Hermes portrait intact

Full desktop capture

🤖 Generated by Fable 5 in T3 Code. Reviewed by Codex XHigh.

Electron rewrites ~/.config/Claude for as long as the app runs, so removing the package and deleting the directory while it is open leaves the app running and the directory back within the same second, holding fresh Preferences and crash-reporter state. Driven end to end on an edge worker: remove via the menu with the app open left 11 processes and a recreated ~/.config/Claude; with the app quit first the directory stayed gone. The test stubs pkill so the suite cannot take a developer's own Claude with it, and asserts the remover reached for it.

Co-Authored-By: Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Codex XHigh <noreply@openai.com>
@spencerbull

spencerbull commented Sep 11, 2026 •

Copy link
Copy Markdown
Contributor Author

Full end-to-end validation of this PR on a disposable Omarchy worker, reviewed by Fable 5.1 in T3 Code with an independent codex second opinion at xhigh reasoning. The worker was switched to the edge package channel (omarchy-refresh-pacman edge, which also took omarchy 4.0.1 → 4.0.3), the PR tree deployed as its OMARCHY_PATH, and the rebuilt font installed by hand because it is package-owned. claude-desktop 1.46388.2-1 resolves from [omarchy] edge there. Every step below was driven through the real menu with ydotool, not by calling the scripts.

Install flow — works. Install > AI lists Claude Desktop with its mark; selecting it opens the floating terminal, pacman pulls omarchy/claude-desktop (159.72 MiB) from edge, the terminal ends with "Claude has been installed", and a com.anthropic.Claude window is mapped with the app running under --ozone-platform=wayland — 17 seconds from keypress to installed package. Afterwards Install > AI shows the entry grayed with a check and Remove > AI lists it alone; after removal both flip back (entry enabled, "Nothing here yet"). Both gates behave.

Install terminal pulling claude-desktop from the edge repo

Claude installed and launched behind the terminal

Package from edge — clean. Under /usr/bin it ships only claude-desktop; the /usr/bin/virtiofsd collision flagged in the first review is gone — the bundled virtiofsd now lives at /usr/libexec/virtiofsd, clear of the Arch package's /usr/lib/virtiofsd — with virtiofsd, qemu-system-x86 and edk2-ovmf listed as optional dependencies for Cowork. A machine carrying a hand-made /usr/libexec/virtiofsd symlink from earlier Cowork experiments refuses the install with "exists in filesystem" until that link is removed; that is local state, not the package. libsecret is a hard dependency, consistent with the keyring-backed storage verified earlier.

Remove flow — one real defect, now fixed in e3392ef. Removing via the menu with the app still open dropped the package and preserved every piece of Claude Code CLI state (~/.claude with a marker file, ~/.claude.json, ~/.cache/claude-cli-nodejs), but ~/.config/Claude was back within the same second as the package removal, holding fresh Preferences and crash-reporter state, and 11 app processes were still running. The rm did run — the original contents were gone — the app simply recreated the directory. A control run that quit the app first left the directory gone. This is the finding codex raised in the first review and I rejected as parity with the ChatGPT remover; the e2e shows the consequence, so that rejection was wrong. The fix quits the app before the drop (pkill -x claude-desktop || true), proven on the worker with the app open: zero processes, zero windows, directory absent ten seconds later, CLI state intact. The test stubs pkill — a real one would take a developer's own Claude with it during the suite — and asserts the remover reached for it; the assertion fails when the line is removed. ChatGPT, Grok Bot, Perplexity and the rest share the original shape and would benefit from the same line, as a follow-up rather than here.

Remove > AI with the app installed

Codex at xhigh on 9d0849f: no findings. It independently confirmed with fontTools that all 22 base glyph outlines and metrics are byte-identical to quattro's font with only claude added — stronger than the rendered comparison in the first review. It was told not to raise the running-app point because I had rejected it, so the correction above is the e2e's doing, not its agreement; where it agrees with earlier conclusions, independence is not guaranteed (same machine, read-only).

Full shell suite at e3392ef: same four environment-specific files failing as on clean quattro on the reviewing machine; remove-ai-test.sh and menu-test.sh pass. Remaining captures: Claude highlighted, install entry gated, remove terminal, install menu after removal, remove menu after removal.

Ready for a maintainer; the package it depends on is live on edge.

🤖 Generated by Fable 5.1 in T3 Code. Reviewed by Codex XHigh.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants