CmdWise Installation Troubleshooting Guide

DMG File Won’t Open

The installer is a standard .dmg file. Double-click to mount it, then drag CmdWise to the Applications folder to finish installation.
If the file refuses to open, delete the installer, download a fresh copy, and try again.

Homebrew Not Found

On the Command App Market page, CmdWise automatically detects whether Homebrew is installed on your system. If not installed, you'll see a prompt to install it, which opens a terminal window to execute the official Homebrew installation script.

If the automatic installation fails, you can manually install Homebrew by following the official website instructions.

Note: The installation executes Homebrew's official script, which requires internet access to download resources. Some resources may have network requirements.

• Official Homebrew website: https://brew.sh/

Installing Homebrew in Chinese Network Environments

If your network cannot access the official Homebrew website, try using the Tsinghua University mirror:

• Tsinghua University mirror: https://mirrors.tuna.tsinghua.edu.cn/help/homebrew/

# Install xcode-select
xcode-select --install

# Open Terminal and execute the following commands
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_INSTALL_FROM_API=1

# Install Homebrew
git clone --depth=1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git brew-install
/bin/bash brew-install/install.sh

# Check if installation was successful
# If successful, displays Homebrew version number
# If failed, displays error message
brew --version

# Update Homebrew
brew update

After installation completes, open CmdWise and go to the Command App Market to check if it works properly.

WARNING

Due to network environment considerations, to make the export commands permanent, add them to your ~/.zshrc or ~/.bashrc file:

echo "export HOMEBREW_BREW_GIT_REMOTE=\"https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git\"" >> ~/.zshrc
echo "export HOMEBREW_CORE_GIT_REMOTE=\"https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git\"" >> ~/.zshrc
echo "export HOMEBREW_INSTALL_FROM_API=1" >> ~/.zshrc

Network Unreachable

1. Verify your network or Wi-Fi is working by opening https://www.apple.com in your browser.
2. Check whether any proxy or VPN software is blocking requests.

CmdWise’s Command App Market fetches app data from https://api.cmdwise.app. Open the URL in a browser to confirm it’s reachable.

Other FAQ

Command App Shows No Styles or Looks Broken

Page rendering depends on styles loaded over the network. Ensure network connectivity and proper access to style files.

CmdWise renders each Command App with external CSS. If the styles don't load, check network connectivity to the following resources:

1. Try accessing TailwindCSS in your browser
2. Try accessing Font Awesome in your browser

If either fails to load, check your network connection or use a proxy to access these resources.

Commands Cannot Be Used

CmdWise itself doesn't provide the actual command implementations. Specific commands are provided by the operating system (e.g., macOS) or third-party tools (e.g., Homebrew). For example, brew install pdfly has operating system version requirements and cannot be used on systems older than macOS 12.

If Homebrew installation commands suggested by CmdWise repeatedly fail, it may be due to unsupported operating system versions. You can try running the command manually in Terminal to see if it works properly.