Projects: work in Salesforce DX folders on your Mac, each tied to one org that stays in view, and deploy, retrieve, test and query from the editor with the commands you know from VS Code.
Projects
- AgentDx opens on your projects, most recent first. Each one is a Salesforce DX folder on your Mac, tied to one org, and that org is named in the title bar, the status bar and the project list.
- New Project creates the Salesforce CLI’s standard project layout in ~/AgentDx or a folder you choose, and can retrieve the org’s code into it.
- Open Project… opens a project made with the Salesforce CLI or VS Code and suggests the org its .sf/config.json names.
- Changing a project’s org asks first and updates .sf/config.json, so the Salesforce CLI and VS Code use the same org.
- If you edited an org’s files in AgentDx 1.1, the first time 1.2 starts they are copied into a project named after that org, ending in “(from AgentDx 1.1)”.
Deploy and retrieve
- Deploy, validate or retrieve a file, a folder, a manifest or the whole project from the Explorer, the editor or the command palette. Settings in sfdx-project.json, such as string replacements, apply as they do in the Salesforce CLI.
- Deploy results list each component, and errors show on the lines they name and in the Problems panel.
- Compare a file with the org’s copy before you deploy or retrieve it.
- Deploy on save, off unless you turn it on, and never for a production org.
- In a production org, a deploy or anonymous Apex needs the org’s alias typed first.
- Deploys and anonymous Apex runs are recorded in the change journal, like the agent’s changes.
Commands from VS Code
- A command palette (⇧⌘P) with SFDX commands named as they are in VS Code’s Salesforce Extensions.
- Create an Apex class, Apex test, trigger, Lightning web component, Aura component or Visualforce page from the palette, or from the folder it belongs in.
- Run anonymous Apex from the open file or a selection, and SOQL from a selection or the palette, with results in a table you can copy as CSV.
- Run Apex tests from Run Test and Run All Tests above a test class, or pick them from a list. Results show each method, the coverage, and a link from each stack trace to its line.
- Get Apex debug logs from the org and open them in the editor.
- Go to File (⌘P), Find in Files (⇧⌘F), Save All, and New File, New Folder, Rename and Move to Trash in the Explorer.
The agent and the editor
- Each chat works in the project’s folder, against the project’s org.
- Completions and error checking for JavaScript, JSON, CSS and HTML files now work in the editor.
Approval and safety
- A shell command is judged by its riskiest step, so a command chained after an sf command gets the approval it would get on its own.
- A command or tool call that names another org is judged by the stricter of that org and the chat’s, so a production deploy started from a sandbox chat asks as one.
- Skills from the bundled Salesforce plugins no longer let a shell command or file edit skip its approval.
Updates
- When an update has downloaded, AgentDx offers to restart into it, and offers again each time it opens until it is installed. Later keeps you working, and quitting installs it.
- An Updates view in the sidebar shows the version you have, the download’s progress and Check for Updates.