From d11b6c8ec38a1f125b9ee16f8b5e8461cce94ca0 Mon Sep 17 00:00:00 2001 From: Alex Jessup Date: Wed, 28 Oct 2026 13:27:53 -0500 Subject: [PATCH 1/2] docs: describe the standard install and removal paths README presented bar placement and Omarchy base packages as extra setup steps, and the uninstall section pointed at an uninstall helper that the git checkout does not contain. Describe the actual `omarchy plugin add --enable` flow, note that the runtime tools ship with Omarchy, and give working removal commands. Refs #3 --- README.md | 36 ++++++++++++++++++++++++------------ SECURITY.md | 5 +++-- 2 files changed, 27 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 4b037f8..7e8df34 100644 --- a/README.md +++ b/README.md @@ -40,11 +40,12 @@ omarchy plugin add https://github.com/GimpyHand/omarchy-t3code.git --enable ``` Omarchy warns that plugins run unsandboxed, clones this repo, validates the -manifest, and enables the plugin. No Node or pnpm needed at runtime. +manifest, and enables the plugin. No Node or pnpm needed at runtime. `--enable` +asks which bar section to use, defaulting to the right section. ```bash -omarchy plugin update bralyx.t3code -omarchy bar put bralyx.t3code --section right --index 0 +omarchy plugin update bralyx.t3code # newer release later +omarchy bar put bralyx.t3code --section right --index 0 # move the widget ``` Or use a release archive: @@ -60,27 +61,38 @@ you to Inbox. ## Requirements - A T3 account with at least one linked environment reachable through Relay -- Omarchy 4.0+ (x86-64) with Quickshell plugins and `wl-paste` -- Secret Service + `secret-tool` -- `xdg-open`, `xdg-mime`, `gzip`, `sha256sum`, graphical browser +- Omarchy 4.0+ (x86-64) with Quickshell plugins +- Secret Service (for the Clerk session and DPoP identity) +- `wl-paste`, `xdg-open`, `xdg-mime`, `gzip`, `sha256sum`, graphical browser + +The tools above ship with Omarchy's base packages (`libsecret`, `wl-clipboard`, +`xdg-utils`, `gzip`, `coreutils`), so a standard install needs nothing extra. +The browser is used only for the one-time sign-in, and `python3` is used for the +NDJSON line relay when present — the launcher runs the bridge directly without +it. Other Linux arches can build a native bridge from source. ## Uninstall -From an installed checkout: - ```bash -~/.config/omarchy/plugins/bralyx.t3code/uninstall +omarchy plugin remove bralyx.t3code ``` -From a release archive (same directory as `install`): +That removes the checkout and its bar widget, but leaves the Secret Service +entries. To clear the stored Clerk client token, callback secret, OAuth token, +and DPoP key as well: ```bash -./uninstall +for item in t3-connect-clerk-client t3-connect-oauth \ + t3-connect-native-callback relay-dpop-proof-key; do + secret-tool clear application bralyx.t3code item "$item" +done ``` -Add `--keep-secrets` to retain the Clerk session and DPoP identity. +Release archives still ship the `./uninstall` helper, where `--keep-secrets` +retains the Clerk session and DPoP identity. From a source checkout, use +`pnpm remove:plugin`. ## Development diff --git a/SECURITY.md b/SECURITY.md index ea21ed3..29aef2e 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -125,8 +125,9 @@ authorization codes, Secret Service output, or DPoP private JWKs. Include the lock-file tag and commit, bridge error code, Omarchy version, and sanitized reproduction steps. -To completely remove the local trust material, run `uninstall` from the -installed marketplace checkout, the packaged `./uninstall`, or +To completely remove the local trust material, run `omarchy plugin remove +bralyx.t3code` and clear the Secret Service entries listed in the +[README](README.md#uninstall), use the packaged `./uninstall`, or run `pnpm remove:plugin` from a source checkout. `--keep-secrets` is available only when deliberately preserving the native session and DPoP identity for a later reinstall. From 1f9aa7e5ff96522ab05059d4a243554503bc6247 Mon Sep 17 00:00:00 2001 From: Alex Jessup Date: Wed, 28 Oct 2026 13:34:26 -0500 Subject: [PATCH 2/2] docs: use bar move for the placement follow-up `omarchy bar put` adds a widget; moving an installed one needs `omarchy bar move`. Also name secret-tool explicitly in the runtime requirements, since the credential path and cleanup call it directly. Refs #3 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 7e8df34..10be009 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,7 @@ asks which bar section to use, defaulting to the right section. ```bash omarchy plugin update bralyx.t3code # newer release later -omarchy bar put bralyx.t3code --section right --index 0 # move the widget +omarchy bar move bralyx.t3code --section right --index 0 # move the widget ``` Or use a release archive: @@ -62,7 +62,7 @@ you to Inbox. - A T3 account with at least one linked environment reachable through Relay - Omarchy 4.0+ (x86-64) with Quickshell plugins -- Secret Service (for the Clerk session and DPoP identity) +- Secret Service and `secret-tool` (for the Clerk session and DPoP identity) - `wl-paste`, `xdg-open`, `xdg-mime`, `gzip`, `sha256sum`, graphical browser The tools above ship with Omarchy's base packages (`libsecret`, `wl-clipboard`,