Skip to main content

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.

CLIProxyAPI Tray organizes its files in the installation directory. Understanding this layout helps when troubleshooting, upgrading, or uninstalling.

​
Installation directory

The install directory depends on how you installed the tray:
MethodDirectory
One-line installer%USERPROFILE%\.cli-proxy-api-tray\
Clone methodThe cloned repository directory itself
The installer does not overwrite config.yaml, settings.json, versions/, or logs/ when upgrading.

​
Files in the install directory

CLIProxyAPI_Tray/
├─ cli-proxy-api.ps1       # Main tray application script
├─ cli-proxy-api.vbs       # Silent launcher (used by the desktop shortcut)
├─ cli-proxy-api.ico       # Application icon
├─ install.ps1             # Installer script
├─ create-shortcut.bat     # Creates or updates the desktop shortcut
├─ config.example.yaml     # Template for config.yaml
├─ config.yaml             # Your config (created from example on first run)
├─ settings.json           # Tray state: version, arch, toggles
├─ versions/               # Downloaded CLIProxyAPI binaries
│  └─ v6.7.37/
│     └─ cli-proxy-api.exe
├─ logs/                   # CLIProxyAPI log files (if logging-to-file: true)
└─ LICENSE
File or folderDescription
cli-proxy-api.ps1The tray application itself. All tray logic lives here.
cli-proxy-api.vbsA VBScript wrapper that launches cli-proxy-api.ps1 silently — no PowerShell console window appears. Used by the desktop shortcut.
cli-proxy-api.icoThe icon shown in the taskbar notification area and on the desktop shortcut.
install.ps1The one-line installer script. Downloads the latest tray files and creates the desktop shortcut.
create-shortcut.batCreates or updates the desktop shortcut pointing to cli-proxy-api.vbs. Run this after cloning to set up the shortcut.
config.example.yamlTemplate configuration file. Copied to config.yaml on first run if config.yaml does not exist.
config.yamlYour active CLIProxyAPI configuration. Passed to CLIProxyAPI via --config. See config.yaml reference.
settings.jsonTray state file. Stores the installed version, architecture, and toggle preferences. See settings.json reference.
versions/Contains all downloaded CLIProxyAPI releases, each in its own subdirectory.
logs/CLIProxyAPI writes log files here when logging-to-file: true is set in config.yaml.

​
Versions directory

Each downloaded CLIProxyAPI release is stored in its own subdirectory: 
versions/
└─ v6.7.37/
   └─ cli-proxy-api.exe
Multiple versions can coexist in the versions/ directory. Older versions are not automatically deleted — only the version recorded in settings.json is used when the service starts. The active version is determined by the version field in settings.json. To switch versions manually, update that field and restart the service.

​
Settings fallback path

If the install directory is not writable, settings.json falls back to a user-local path: 
%LOCALAPPDATA%\CLIProxyAPI_Tray\settings.json
A balloon tip notifies you when this fallback is used. See settings.json: tray state and preferences for details on how the tray resolves which file to use.

​
Logs directory

CLIProxyAPI writes rotating log files to logs/ when logging-to-file: true is set in config.yaml. The tray does not create or manage log files itself — log rotation and cleanup are handled by CLIProxyAPI according to the logs-max-total-size-mb and error-logs-max-files settings.
Use Open → Folder from the tray menu to open the install directory in Windows Explorer.

Build docs developers (and LLMs) love

Get started for freeTalk to us