Skip to main content

Uninstall Forge

Uninstall Forge Code from your system.

For Global npm Uninstallation​

If you installed Forge using npm install -g forgecode@latest, follow these steps to uninstall:

1

Uninstall

npm uninstall -g forgecode

This removes the globally installed Forge package from your system.

2

Verify Removal

Check that Forge has been removed:

forge --version

You should see an error indicating the command is not found, confirming successful removal.

For npx Usage​

If you've been using npx forgecode@latest, no uninstallation is required. The npx command downloads and runs Forge temporarily without installing it permanently on your system.

No Installation = No Uninstallation

Since npx forgecode@latest doesn't install anything permanently, there's nothing to uninstall. Each time you run the command, it downloads the latest version temporarily.

Optionally, you can clear the npx cache to free up disk space:

npm cache clean --force

Clean Up Configuration and Data​

After uninstalling the main application, you may want to remove associated configuration files and data:

1

Remove Forge configuration directory

Delete the forge folder from your home directory. This folder contains your authentication tokens, custom agents, and local configurations.

Location:

  • macOS/Linux: ~/forge/
  • Windows: %USERPROFILE%\forge\
2

Remove project-specific configurations (optional)

Look for forge.yaml files in your project directories and delete them if no longer needed. These files contain project-specific Forge settings and agent configurations.

Verify Removal​

1

Check command availability

forge --version

The command should return "not found" or a similar error.

Troubleshooting Uninstallation​

Permission Issues​

If you encounter permission errors during uninstallation:

macOS/Linux:

sudo npm uninstall -g forgecode

Windows (Run as Administrator):

npm uninstall -g forgecode

npm Cache Issues​

If you experience issues with npm, clear the npm cache:

npm cache clean --force

Need Help?​

If you encounter issues during uninstallation:

Success

Forge Code has been removed from your system. Thank you for trying Forge Code!