diff --git a/AGENTS.md b/AGENTS.md index 9021209..a65813c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,12 +2,12 @@ ## Project Overview -macOS CLI tool (`scripts/citrix.sh`) for safely parking and unparking Citrix Workspace using `launchctl bootout`/`bootstrap` in correct dependency order, avoiding the reboot required by naive process killing. +macOS CLI tool (`scripts/cwm.sh`) for safely parking and unparking Citrix Workspace using `launchctl bootout`/`bootstrap` in correct dependency order, avoiding the reboot required by naive process killing. ## Repository Structure ``` -scripts/ # Shell scripts (citrix.sh is the main entry point) +scripts/ # Shell scripts (cwm.sh is the main entry point) openspec/ specs/ # Living documentation of current system state changes/ # Active change proposals (SDD workflow) @@ -35,19 +35,19 @@ Manual verification on macOS: ```bash # Full cycle test -sudo ./scripts/citrix.sh stop -./scripts/citrix.sh status # expect all unloaded, 0 processes -sudo ./scripts/citrix.sh start -./scripts/citrix.sh status # expect all loaded +sudo ./scripts/cwm.sh stop +./scripts/cwm.sh status # expect all unloaded, 0 processes +sudo ./scripts/cwm.sh start +./scripts/cwm.sh status # expect all loaded ``` ```bash # Dry-run (no side effects) -sudo ./scripts/citrix.sh --dry-run stop +sudo ./scripts/cwm.sh --dry-run stop ``` ## Lint / Check ```bash -shellcheck scripts/citrix.sh +shellcheck scripts/cwm.sh ``` diff --git a/README.md b/README.md index 64e6ce3..903d41b 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# osx-citrix-manager-cli +# Citrix Workspace Manager (`cwm`) A macOS CLI tool to safely park and unpark Citrix Workspace without requiring a reboot. @@ -13,7 +13,7 @@ Simply killing Citrix Workspace processes leaves macOS in a broken state: ## The Solution -`citrix.sh` uses `launchctl bootout`/`bootstrap` to cleanly unload and reload all Citrix services in the correct dependency order — no reboot required. +`cwm` uses `launchctl bootout`/`bootstrap` to cleanly unload and reload all Citrix services in the correct dependency order — no reboot required. ### Stop (Park) @@ -31,29 +31,38 @@ Reloads services hub-to-edge: bootstraps system LaunchDaemons first, then user L ## Installation +### Via Homebrew (recommended) + +```bash +brew tap 5L-Labs/citrix-cli +brew install citrix-workspace-manager +``` + +### Manual + ```bash -git clone https://github.com/NickJLange/osx-citrix-manager-cli.git +git clone https://github.com/5L-Labs/osx-citrix-manager-cli.git cd osx-citrix-manager-cli -chmod +x scripts/citrix.sh +chmod +x scripts/cwm.sh ``` ## Usage ```bash # Check current Citrix status -./scripts/citrix.sh status +cwm status # Stop (park) all Citrix services -sudo ./scripts/citrix.sh stop +sudo cwm stop # Start (unpark) all Citrix services -sudo ./scripts/citrix.sh start +sudo cwm start # Preview what would happen without making changes -sudo ./scripts/citrix.sh --dry-run stop +sudo cwm --dry-run stop # Verbose output for debugging -sudo ./scripts/citrix.sh --verbose start +sudo cwm --verbose start ``` ## Commands diff --git a/scripts/citrix.sh b/scripts/cwm.sh similarity index 100% rename from scripts/citrix.sh rename to scripts/cwm.sh