From fa60a8b9bffc2a48707e6e323edd7155914b8852 Mon Sep 17 00:00:00 2001
From: Spencer Bull <spencerbull2554@gmail.com>
Date: Tue, 1 Sep 2026 09:26:38 -0500
Subject: [PATCH] Add the Perplexity desktop app to Install > AI

Follows the T3 Code / Grok Bot flow: the Install > AI entry runs
omarchy-install-and-launch, so picking it installs the perplexity
package on demand and launches the app when the install finishes.
Remove > AI drops the package along with the app's own config, flags
file, and rpc-server runtime cache, keeping the perplexity-* caches
that belong to Perplexity's other products. Like the Hermes remover,
it sets -u so an unset HOME is a refusal rather than rm -rf paths
rooted at /.

The menu mark is a new U+E90B glyph in the Omarchy icon font, 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>
---
 bin/omarchy-remove-ai-perplexity   |  21 +++++++++++++++++++++
 default/fonts/omarchy/README.md    |   3 ++-
 default/fonts/omarchy/omarchy.ttf  | Bin 5284 -> 5492 bytes
 default/omarchy/omarchy-menu.jsonc |   2 ++
 manual/17-ai.md                    |   2 +-
 test/shell.d/menu-test.sh          |   2 +-
 test/shell.d/remove-ai-test.sh     |  25 +++++++++++++++++++++++++
 7 files changed, 52 insertions(+), 3 deletions(-)
 create mode 100755 bin/omarchy-remove-ai-perplexity

diff --git a/bin/omarchy-remove-ai-perplexity b/bin/omarchy-remove-ai-perplexity
new file mode 100755
index 00000000..c2388738
--- /dev/null
+++ b/bin/omarchy-remove-ai-perplexity
@@ -0,0 +1,21 @@
+#!/bin/bash
+
+# omarchy:summary=Remove the Perplexity desktop app along with its configuration and caches.
+# omarchy:requires-sudo=true
+
+# -u so an unset HOME is an error rather than a set of rm -rf paths rooted at /.
+set -euo pipefail
+
+omarchy-pkg-drop perplexity
+
+# Of the perplexity-* dirs under ~/.cache, only the rpc-server runtime is the
+# desktop app's own download; the rest belong to Perplexity products that
+# outlive the desktop app.
+rm -rf \
+  "$HOME/.config/Perplexity" \
+  "$HOME/.cache/Perplexity" \
+  "$HOME/.cache/perplexity-rpc-server"
+rm -f "$HOME/.config/perplexity-flags.conf"
+
+echo ""
+echo "Perplexity has been removed."
diff --git a/default/fonts/omarchy/README.md b/default/fonts/omarchy/README.md
index a4ab6935..e538684d 100644
--- a/default/fonts/omarchy/README.md
+++ b/default/fonts/omarchy/README.md
@@ -13,7 +13,8 @@ The private-use glyphs in `omarchy.ttf` are:
 - `U+E908` — T3 Code, traced from the app icon in <https://aur.archlinux.org/cgit/aur.git/plain/t3code-icon.png?h=t3code-bin>, since upstream publishes no monochrome SVG
 - `U+E909` — Ori, from <https://openrouter.ai/brand/v2/openrouter-glyph-dark.svg>, OpenRouter's own mark: Ori ships no separate logo and its product page uses this one
 - `U+E90A` — Hermes, Font Awesome's staff-snake (CC BY 4.0) from <https://fontawesome.com/icons/staff-snake>, the mark Hermes serves as its favicon: their app icon is a portrait that reads as a smudge at menu size
-- `U+E90C` — OpenClaw, traced from the lobster mascot the openclaw package ships as `dist/control-ui/favicon.svg`, since upstream publishes no monochrome SVG; `E90B` is left for the Perplexity mark already in flight on another branch
+- `U+E90B` — Perplexity, from <https://simpleicons.org/icons/perplexity.svg>
+- `U+E90C` — OpenClaw, traced from the lobster mascot the openclaw package ships as `dist/control-ui/favicon.svg`, since upstream publishes no monochrome SVG
 
 The agent marks are monochrome so the menu can render them using the active
 theme's foreground and selection colors.
diff --git a/default/fonts/omarchy/omarchy.ttf b/default/fonts/omarchy/omarchy.ttf
index fb9d22a74a6638b60b4f3a701a081a36169fe3db..7a26ed1deacde7f421ccbd80fec05fde1ec369f2 100644
GIT binary patch
delta 610
zcmXYtPiPZC6vn@|n>2qd-6oqf6l+5gQftuSnp!+XJg8Odp`{luu4y#Fu32gh2^8uf
z2Ty8Q@gRbS2vQIU1gcUG#ft?I{DZVu@F0sJ)m&^3qPX!TbROTl`F%6InR$;7?vCCK
zE#egbZEE_+(b*4YPXjc<d?~A|#;4Wf9P=$e7{98OuUyXGd;^GUK<}A+PMtga?8I%L
z-_7U8^K7`u5n|3T$MbrzbPSHK%v=LAS|O_j|AtqYUofY1wPa9|YDl8rVq^Has^{J{
zzTX1^4!-oQQMgg8zWjF)2)^h2syPwV%n8b#b25pY5-dK6hajFoW9)WTDbC)m?|{L1
z0DbJZp(2YsbQCa;auZE&(`OC~k%+J9Z@1f3jz{hLZIk0pn8NO`$Gjj6N`Rkh0Q|1*
z@R=o{;PC-X7J_w4kg1+<)b=g9uz-wM;r0X&LIgvI@#pxJ6q6HjEbUCkBt>$j6*(a(
zQ6=qEl4AOJR7yxLSxzLSa3C6%6|th(cFMLjjf4~p%-YY_?Y@<jLzcZor#9%z#)f8Z
zStm*P)%ezE?NEh0t;TlC{u5tbeqv+NvOjvMXEVFByJ_#N(GP2~+Z0li{S9|wX??0k
z?)<}Hl6YW@+m~TIVCj474tMl)FKe7@tZCMQ`CA-yyW-u7vN=S9_0Q5zBH4T$7!jz~
T+zy=gdyU+@q2)@~ie>x<=@_4a

delta 412
zcmZ9GKS%;m9LK-!-I;MI)p=Qzkc35w6l6q1L$pK?I2h6BW!6D=os@%44lPYlJgI1E
zXp9nWX)vKV8iK~AhRSFNa|jyjr(-<6zu)_Qet+JpM=rvL{(?3Qz>FuxCsrO87Xa4u
z$&{sM%JX~6<evaOv}xuy`fJZ$fE)t6B_pk`k6q0iP;Z$uWe{j*atGb(q>y1{bBe-O
zY5tV_tZAoo?YHX$kbcNVEIpTDBdmlNSRaAlwr-^#-d>A9H$BMiGxl!w=B4ru_|B<*
z3`UW~Vy@&?L}+T<t+a?HKGXpbW@{X>xZ{Hb8JNQvEQ-x@NitDFf~H+0i4-MK8;Y$B
zU;(1d?NQ1~i_0)5`_V<D4LVZfE!fyWzKW_+^)wn(|IZn5@y#^J4Mu<I?etI+u-}S+
mA||=*TyvF)AeY6hI_y*=$LqL!pNwgurj3d~&k_fY%H|(ssa*B|

diff --git a/default/omarchy/omarchy-menu.jsonc b/default/omarchy/omarchy-menu.jsonc
index a82254c6..d824319e 100644
--- a/default/omarchy/omarchy-menu.jsonc
+++ b/default/omarchy/omarchy-menu.jsonc
@@ -245,6 +245,7 @@
   "install.ai.lm-studio": {"icon":"","iconFont":"omarchy","label":"LM Studio","disabled":"omarchy-pkg-present lmstudio-bin","action":"omarchy-install-app 'LM Studio' lmstudio-bin"},
   "install.ai.ollama": {"icon":"","iconFont":"omarchy","label":"Ollama","disabled":"omarchy-cmd-present ollama","action":"if omarchy-cmd-present nvidia-smi; then ollama_pkg=ollama-cuda; elif omarchy-cmd-present rocminfo; then ollama_pkg=ollama-rocm; else ollama_pkg=ollama; fi; omarchy-install-app Ollama \"$ollama_pkg\""},
   "install.ai.openclaw": {"icon":"","iconFont":"omarchy","label":"OpenClaw","disabled":"omarchy-pkg-present openclaw","action":"omarchy-launch-floating-terminal-with-presentation omarchy-install-ai-openclaw"},
+  "install.ai.perplexity": {"icon":"","iconFont":"omarchy","label":"Perplexity","disabled":"omarchy-pkg-present perplexity","action":"omarchy-install-and-launch Perplexity perplexity perplexity"},
   "install.ai.t3-code": {"icon":"","iconFont":"omarchy","label":"T3 Code","disabled":"omarchy-pkg-present t3code-bin","action":"omarchy-install-and-launch 'T3 Code' t3code-bin t3code"},
   "install.gaming.steam": {"icon":"","label":"Steam","disabled":"omarchy-pkg-present steam","action":"omarchy-launch-floating-terminal-with-presentation omarchy-install-gaming-steam"},
   "install.gaming.retroarch": {"icon":"󰯉","label":"RetroArch","disabled":"omarchy-pkg-present retroarch","action":"omarchy-launch-floating-terminal-with-presentation omarchy-install-gaming-retroarch"},
@@ -311,6 +312,7 @@
   "remove.ai.lm-studio": {"icon":"","iconFont":"omarchy","label":"LM Studio","when":"omarchy-pkg-present lmstudio-bin","action":"omarchy-launch-floating-terminal-with-presentation omarchy-remove-ai-lm-studio"},
   "remove.ai.ollama": {"icon":"","iconFont":"omarchy","label":"Ollama","when":"omarchy-pkg-present ollama","action":"omarchy-launch-floating-terminal-with-presentation omarchy-remove-ai-ollama"},
   "remove.ai.openclaw": {"icon":"","iconFont":"omarchy","label":"OpenClaw","when":"omarchy-pkg-present openclaw","action":"omarchy-launch-floating-terminal-with-presentation omarchy-remove-ai-openclaw"},
+  "remove.ai.perplexity": {"icon":"","iconFont":"omarchy","label":"Perplexity","when":"omarchy-pkg-present perplexity","action":"omarchy-launch-floating-terminal-with-presentation omarchy-remove-ai-perplexity"},
   "remove.ai.t3-code": {"icon":"","iconFont":"omarchy","label":"T3 Code","when":"omarchy-pkg-present t3code-bin","action":"omarchy-launch-floating-terminal-with-presentation omarchy-remove-ai-t3-code"},
   "remove.gaming.steam": {"icon":"","label":"Steam","when":"omarchy-pkg-present steam","action":"omarchy-launch-floating-terminal-with-presentation omarchy-remove-gaming-steam"},
   "remove.gaming.retroarch": {"icon":"","label":"RetroArch","when":"omarchy-pkg-present retroarch","action":"omarchy-launch-floating-terminal-with-presentation omarchy-remove-gaming-retroarch"},
diff --git a/manual/17-ai.md b/manual/17-ai.md
index f94c3546..8a9c5852 100644
--- a/manual/17-ai.md
+++ b/manual/17-ai.md
@@ -44,7 +44,7 @@ Crashes can also be silenced one program at a time, which is what the diagnosis
 
 ### Desktop apps
 
-The _Install > AI_ menu also carries a few graphical AI apps: the ChatGPT desktop app, Grok Bot for chatting with xAI's models, Hermes Desktop, and OpenClaw.
+The _Install > AI_ menu also carries a few graphical AI apps: the ChatGPT desktop app, Grok Bot for chatting with xAI's models, Hermes Desktop, OpenClaw, and the Perplexity desktop app.
 
 Hermes Desktop is the one to know about, because there is only ever one Hermes on a machine. The app only runs against a runtime built from its own commit, so it installs one of its own under `~/.hermes` on first launch, which takes a few minutes and shows its own progress. From then on that is the Hermes the terminal `hermes` command and the default agent use too, whichever order you installed them in. Removing the app under _Remove > AI_ takes that runtime with it, and keeps your chats, memories, and the skills Hermes wrote for itself.
 
diff --git a/test/shell.d/menu-test.sh b/test/shell.d/menu-test.sh
index 3907a8e2..c65ec000 100644
--- a/test/shell.d/menu-test.sh
+++ b/test/shell.d/menu-test.sh
@@ -638,5 +638,5 @@ assert(
 JS
 
 font_charset=$(fc-query --format='%{charset}' "$ROOT/default/fonts/omarchy/omarchy.ttf")
-[[ $font_charset == *"e900-e90a"* && $font_charset == *"e90c"* ]] || fail "Omarchy icon font includes every custom menu glyph"
+[[ $font_charset == *"e900-e90c"* ]] || fail "Omarchy icon font includes every custom menu glyph"
 pass "Omarchy icon font includes the official agent marks"
diff --git a/test/shell.d/remove-ai-test.sh b/test/shell.d/remove-ai-test.sh
index a10bc3b6..99558353 100644
--- a/test/shell.d/remove-ai-test.sh
+++ b/test/shell.d/remove-ai-test.sh
@@ -75,6 +75,31 @@ for kept in .grok .claude.json .npm .local/share/opencode; do
 done
 pass "T3 Code removal keeps the agent state it bootstrapped"
 
+# Perplexity's other products (the CLI, Comet) share the perplexity-* cache
+# prefix; only the rpc-server runtime is the desktop app's own.
+fresh_home
+mkdir -p "$HOME/.config/Perplexity" "$HOME/.cache/Perplexity" "$HOME/.cache/perplexity-rpc-server" "$HOME/.cache/perplexity-personal-computer-poc"
+touch "$HOME/.config/perplexity-flags.conf"
+"$ROOT/bin/omarchy-remove-ai-perplexity" >/dev/null
+
+for gone in .config/Perplexity .cache/Perplexity .cache/perplexity-rpc-server .config/perplexity-flags.conf; do
+  [[ ! -e $HOME/$gone ]] || fail "Perplexity removal deletes the desktop app's own data" "$gone"
+done
+pass "Perplexity removal deletes the desktop app's own data"
+
+[[ -d $HOME/.cache/perplexity-personal-computer-poc ]] || fail "Perplexity removal keeps other Perplexity products' caches"
+pass "Perplexity removal keeps other Perplexity products' caches"
+
+grep -qx 'drop:perplexity' "$TEST_LOG" || fail "Perplexity removal drops the perplexity package"
+pass "Perplexity removal drops the perplexity package"
+
+# Without HOME the rm -rf paths would degrade to /-rooted ones; -u makes that a
+# refusal instead.
+if env -u HOME "$ROOT/bin/omarchy-remove-ai-perplexity" >/dev/null 2>&1; then
+  fail "Perplexity removal refuses to run without HOME"
+fi
+pass "Perplexity removal refuses to run without HOME"
+
 # ~/.grok belongs to the Grok CLI that omarchy-default-agent installs.
 fresh_home
 mkdir -p "$HOME/.config/Grok Bot" "$HOME/.grokbot" "$HOME/.grok"