Installation and Upgrade Issues

​

command not found

• After a global installation via npm, ensure the global bin directory is added to your PATH:
  Copy

  npm config get prefix   # Check the global installation prefix
  # Add <prefix>/bin to PATH
  
• After modifying your PATH, apply the changes: on Linux / macOS, after editing the shell configuration file (such as ~/.zshrc or ~/.bashrc), restart the terminal or run source; on Windows, after modifying system environment variables, restart the terminal.
• Verify the installation location:
  Copy

  # Linux / macOS
  which qodercli
  
  Copy

  # Windows
  where qodercli          # Command Prompt
  Get-Command qodercli    # PowerShell
  
• If installation fails or no binary is available on Windows arm64 devices: this platform is not currently supported. See Installation and Upgrade.

​

permission denied

• If you encounter permission errors during global installation, avoid forcing the installation with administrator privileges. It is recommended to change the npm Global Directory to a user-writable path and then reinstall.
• Using a Version Manager (such as nvm) to manage your runtime can avoid permission issues with system-level directories.

​

Upgrade Failed or Version Not Updated

• First, run the built-in update command:
  Copy

  qodercli update
  
• If the old version is still displayed after upgrading, first check which binary is currently being invoked (use where qodercli on Windows):
  Copy

  which qodercli
  qodercli --version
  
• If installed via multiple channels (e.g., using both npm and Homebrew), multiple qodercli may exist, and the one appearing first in your PATH will be invoked. Uninstall the versions from redundant channels and keep only one.
• After cleanup, reinstall the latest version via the original channel: for script installations, use curl -fsSL https://qoder.com/install | bash -s -- --force to force a reinstall; for npm installations, use npm install -g @qoder-ai/qodercli@latest. See Installation and Upgrade for details.

​

Duplicate Installations / Multi-Version Conflicts

• List all matching executables to check for multiple copies: use which -a qodercli on Linux / macOS, and where qodercli (Command Prompt) or Get-Command qodercli -All (PowerShell) on Windows.
• Keep only one installation channel and remove the others to avoid version confusion.

​

Verify Installation

qodercli --version
qodercli --help

​

Next Steps

• Installation and upgrade guide: Installation and Upgrade.
• Network issues during download or installation: Network, Proxy, and VPC Issues.
• Sign-in issues: Sign-in and Authentication Issues.