> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxycode.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Installation
> Install MoxyCode and start fixing Salesforce deployment errors in minutes.
## Requirements
Before installing, make sure you have:
* **VS Code** 1.85 or later
* **Salesforce CLI** (`sf`) installed and authenticated
* An active Salesforce org connection in VS Code
To check your Salesforce CLI version, run `sf --version` in your terminal. To install it, visit [developer.salesforce.com/tools/salesforcecli](https://developer.salesforce.com/tools/salesforcecli).
## Install MoxyCode
### From the VS Code Marketplace
1. Open VS Code
2. Press `Cmd+Shift+X` (Mac) or `Ctrl+Shift+X` (Windows) to open the Extensions panel
3. Search for **MoxyCode**
4. Click **Install**
### From the terminal
```bash theme={null}
code --install-extension aptivate.moxycode
```
## Start using MoxyCode
No sign-in required to get started. Once installed, MoxyCode is ready to use immediately — open any Apex or LWC file and run your first deploy.
Your first **2 requests are free** with no account needed. MoxyCode will prompt you to sign in before your third request.
## Sign in
After your second request, MoxyCode will automatically show a sign-in prompt inside VS Code. You do not need to go to the website.
1. Enter your email address in the sign-in prompt
2. Click **Send Magic Link**
3. Check your inbox for an email from MoxyCode
4. Click the link — VS Code opens automatically and signs you in
5. Re-trigger your original request to continue
Once signed in, MoxyCode stays signed in. You will not be asked to sign in again.
To view your account details, visit [moxycode.com](https://moxycode.com) and sign in with the same email address.
The magic link expires after 15 minutes. If it expires, return to VS Code and request a new one.
## Connect your Salesforce org
MoxyCode uses your active Salesforce CLI default org. To set one:
1. Look at the bottom status bar in VS Code
2. Click the org name (or **No Default Org Set**)
3. Select **Authorize an Org** if you haven't connected one yet, or choose from your existing orgs
4. Once set, the org name appears in the status bar — MoxyCode will deploy to that org
Make sure the correct org is active before deploying — MoxyCode always deploys to your current default org.
## Common issues
The extension may not have activated yet. Try opening any `.cls`, `.trigger`, `.js`, or `.html` file — MoxyCode activates when a supported file type is opened. If the icon still doesn't appear, save the file once to trigger activation. If it's still missing, run **Developer: Reload Window** from the Command Palette.
Check your spam or junk folder. The email is sent from `auth@moxycode.com`. If it's not there after a few minutes, return to VS Code and click **Send Magic Link** again.
This can happen if VS Code is not set as the default handler for `vscode://` links on your machine. Make sure VS Code is open before clicking the link, then try again.
The sign-in prompt triggers automatically on your third request. If it doesn't appear, try reloading VS Code with **Developer: Reload Window** from the Command Palette and making the request again.
MoxyCode requires the Salesforce CLI to be installed and available in your terminal PATH. Run `sf --version` to verify. If it's not installed, download it from [developer.salesforce.com/tools/salesforcecli](https://developer.salesforce.com/tools/salesforcecli).
See MoxyCode in action in under 2 minutes
### From the terminal
```bash theme={null}
code --install-extension aptivate.moxycode
```
## Start using MoxyCode
No sign-in required to get started. Once installed, MoxyCode is ready to use immediately — open any Apex or LWC file and run your first deploy.
Your first **2 requests are free** with no account needed. MoxyCode will prompt you to sign in before your third request.
## Sign in
After your second request, MoxyCode will automatically show a sign-in prompt inside VS Code. You do not need to go to the website.
1. Enter your email address in the sign-in prompt
2. Click **Send Magic Link**
3. Check your inbox for an email from MoxyCode
4. Click the link — VS Code opens automatically and signs you in
5. Re-trigger your original request to continue
## Connect your Salesforce org
MoxyCode uses your active Salesforce CLI default org. To set one:
1. Look at the bottom status bar in VS Code
2. Click the org name (or **No Default Org Set**)
3. Select **Authorize an Org** if you haven't connected one yet, or choose from your existing orgs
4. Once set, the org name appears in the status bar — MoxyCode will deploy to that org
