> ## 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.

# Quick Start

> Fix your first Salesforce deployment error in under 2 minutes.

<iframe width="100%" height="400" src="https://www.youtube.com/embed/YOUR_VIDEO_ID" title="MoxyCode Quick Start" frameBorder="0" allowFullScreen />

MoxyCode works alongside your normal Salesforce development workflow. You deploy as usual — MoxyCode steps in automatically when something goes wrong.

## Fix your first deployment error

### Step 1 — Open a file and deploy

Open any Apex class, trigger, or LWC component in VS Code. Right-click inside the editor or in the Explorer panel and select **MoxyCode: Deploy to Org**.

Or run it from the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`):

MoxyCode: Deploy to Org

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/moxycode/images/quick-start-deploy.png" alt="MoxyCode Deploy to Org in the right-click menu" />
</Frame>

### Step 2 — MoxyCode opens automatically on failure

If the deploy fails, MoxyCode shows a notification at the bottom of VS Code:

**"MoxyCode: n deployment error(s) found."**

The **MoxyCode — Deploy Errors** panel opens automatically with every error listed.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/moxycode/images/quick-start-errors.png" alt="MoxyCode Deploy Errors panel" />
</Frame>

### Step 3 — Understand the error

Click **Explain** on any error to get a full AI analysis. The explanation includes:

* What the error means in plain English
* Exactly why it is happening in your specific code
* A suggested fix with a code example you can copy

Each **Explain** click uses 1 of your 5 daily AI requests on the Free plan.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/moxycode/images/quick-start-explain.png" alt="MoxyCode Explain view" />
</Frame>

<Note>
  On the Free plan, copy the suggested fix from the Explain view and apply it manually. **Analyze & Generate Fixes** — which generates and applies fixes automatically — is a Pro feature.
</Note>

### Step 4 — Generate and apply fixes (Pro)

On Pro, click **Analyze & Generate Fixes** to generate a complete fix for every error at once. Each fix shows:

* **Fixed Code** — the corrected version ready to apply
* **What Changed** — a plain-English summary of what was modified and why
* **Overall Summary** — confidence and risk rating

Click **Apply Fix**. The button changes to **Fix Applied** and a notification appears:

**"MoxyCode: Fix applied — changed lines highlighted in green. Save to confirm."**

Click **Save File** in the notification to accept, or **Undo Fix** to revert.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/moxycode/images/quick-start-fix-applied.png" alt="MoxyCode fix applied notification" />
</Frame>

### Step 5 — Deploy again

Run **MoxyCode: Deploy to Org** again. Your code should deploy cleanly.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/moxycode/images/quick-start-success.png" alt="MoxyCode deployment successful notification" />
</Frame>

<Note>
  Some errors are layered — fixing one can reveal another underneath. Repeat the deploy-fix cycle until the deployment succeeds cleanly.
</Note>

## Sign in prompt

If this is your third request, MoxyCode will show a sign-in prompt before proceeding. Your first two requests are free with no account needed.

1. Enter your email and click **Send Magic Link**
2. Check your inbox for an email from `auth@moxycode.com`
3. Click the link — VS Code opens and signs you in automatically
4. Re-trigger your original request to continue

<Note>
  The magic link expires after 15 minutes. If it expires, return to VS Code and request a new one.
</Note>

## Common issues

<AccordionGroup>
  <Accordion title="Deploy Errors panel didn't open after a failed deploy">
    The panel opens automatically when MoxyCode detects errors in the Salesforce CLI output. Make sure you are using **MoxyCode: Deploy to Org** and not the standard Salesforce CLI deploy command — MoxyCode only monitors its own deploys.
  </Accordion>

  <Accordion title="Analyze & Generate Fixes button shows Upgrade to Pro">
    Analyze & Generate Fixes is a Pro feature. On the Free plan, click **Explain** on each individual error to get AI analysis and a suggested fix you can copy manually.
  </Accordion>

  <Accordion title="Hit the 5 request limit">
    The 5 daily AI request limit on the Free plan is shared across the entire product — Explain clicks, chat messages, and code analysis requests all count. The limit resets 24 hours after your 5th request was made. Upgrade to Pro for unlimited requests.
  </Accordion>

  <Accordion title="Fix applied but deploy still fails">
    Some errors are layered — fixing one can reveal another underneath. Run **MoxyCode: Deploy to Org** again and repeat the fix cycle. MoxyCode will catch the next error in the same way.
  </Accordion>

  <Accordion title="Deploy succeeds but I expected errors">
    MoxyCode only opens the errors panel when the deploy fails. A successful deploy means your code is clean — no action needed.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Fix Deployment Errors" icon="wrench" href="/workflows/fix-deployment-errors">
    Learn more about how the fix engine works
  </Card>

  <Card title="Code Analysis" icon="magnifying-glass" href="/workflows/code-analysis">
    Catch issues before you deploy
  </Card>
</CardGroup>