CLIProxyAPI Tray can be installed in two ways. The one-line installer is the fastest path — it downloads the latest files and creates a desktop shortcut in one command. The clone method is better if you want to track changes through git or contribute to the project.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/kitephp/CLIProxyAPI-Tray/llms.txt
Use this file to discover all available pages before exploring further.
- Method A: One-line installer
- Method B: Clone repository
Open PowerShell
Open Windows PowerShell 5.1 (search for “Windows PowerShell” in the Start menu) or PowerShell 7 (
pwsh). Either version works.Run the installer
Paste and run the following command:The installer downloads the latest files from the
main branch, copies them to the install directory, and creates a desktop shortcut named CLIProxyAPI Tray.Check the install directory
The default install location is:You can open this folder in Explorer to confirm the files are present.
Use the desktop shortcut
A shortcut named CLIProxyAPI Tray is placed on your desktop. Double-click it to launch the tray application. See Get started for what happens on first launch.
The installer never overwrites an existing
config.yaml, settings.json, versions/, or logs/ directory. Re-running the installer is safe and updates only the application scripts.Installer parameters
When using Method A, you can pass parameters toinstall.ps1 to customise the installation. The table below lists all available parameters.
| Parameter | Type | Default | Description |
|---|---|---|---|
-InstallDir | string | %USERPROFILE%\.cli-proxy-api-tray | Override the install location. Accepts any absolute path. |
-ShortcutShell | Auto | WindowsPowerShell | PowerShell7 | Auto | Shell used by the desktop shortcut. Auto prefers pwsh.exe if it is found on PATH, otherwise falls back to Windows PowerShell. |
-NoShortcut | switch | off | Skip creating the desktop shortcut. |
-Branch | string | main | Branch to install from. Useful for testing pre-release branches. |
How the launcher works
The desktop shortcut does not callpowershell.exe or pwsh.exe directly. Instead it calls wscript.exe with cli-proxy-api.vbs as the target. The VBScript launcher:
- Looks for
pwsh.exeonPATHand in the default PowerShell 7 install locations. - Falls back to
%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exeifpwsh.exeis not found. - Runs
cli-proxy-api.ps1with-STA -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass.
-WindowStyle Hidden flag means no console window appears when you launch the tray. Everything happens silently in the background, with the tray icon as the only visible surface.