2026-10-28 · 0.1.5
Orgbench 0.1.5
Released 2026-10-28 for IntelliJ IDEA and VS Code. This release covers everything that changed since 0.1.4, the previous public release.
Orgbench 0.1.5 takes Revenue Cloud deployments to production orgs: one Deploy moves the metadata, the product bundles and the constraint models in phases, and a pricing procedure version travels together with the decision tables it reads. Lightning pages, report types and context definitions can now be merged element by element, like page layouts, and the mode is chosen for each document. Rows the target did not accept can be deployed again from the results screen, and the Target health check lets you choose the right record when the target holds duplicates. As before, everything runs on your machine, by default over your own Salesforce CLI; your metadata leaves it only if you turn on Describe differences with Claude Code.
Highlights
- Production deployments in phases. Against a production org Orgbench offers Validate and Deploy, with a Deployment plan above the buttons. Deploy sends the metadata as one atomic deployment, and transfers product bundles and constraint models only after it succeeded.
- Pricing procedure versions with their decision tables. One deployment moves a version together with the decision tables it reads, in every deploy mode. A decision table active in both the source and the target is deactivated for the deployment and activated again after it, and the version is activated after its tables; Validate only activates nothing.
- Element-level merge for more documents. Lightning pages (fields, components and page assignments), report types (columns) and context definitions (new elements only) join page layouts. An Elements checkbox next to each document on the selection screen decides its mode.
- Re-Deploy from the results screen. Check the rows the target did not accept and deploy them again in the same mode, without a new comparison.
- Duplicates in the target, resolved on screen. When a bundle record matches several records of the target, the Target health check lets you choose the one the deployment updates. Check target checks the target's references before any comparison, and changes nothing.
- Open the org in your browser. An icon next to each org opens it, and a Deployment Status link follows a running deployment in Setup. The progress line numbers the packages of a deployment:
Deploying the package — 2 of 3. - Describe differences with Claude Code. An optional, off-by-default row menu item hands the two versions of one Flow, Apex class or Apex trigger to your own local Claude Code, which sends them to the model provider it is set up for, and shows its plain-English account of the differences.
Deploying to a production org
-
No Best Effort against production. The last step offers Validate and Deploy only. A Deployment plan above the buttons names the steps Deploy will take for the rows checked right now.
-
Deploy runs in phases, and a phase starts only after the previous one succeeded:
- the metadata, including the definitions of the selected constraint models and the permission changes, as one atomic Metadata API deployment (several when Salesforce needs them, see below), followed by activating the decision tables and pricing procedure versions it sent inactive;
- the Target health check fix, if you chose it, and then the product bundles as records;
- the tags, constraint model text and activation of each selected constraint model.
A row whose phase did not start says why. Once the cause is fixed, Re-Deploy finishes it.
-
Validate checks the metadata phase only and changes nothing. Quick Deploy after it runs the metadata from the validated job and then the remaining phases.
-
Fix during Deploy. Against production the Target health check button is called Fix during Deploy and deletes nothing at once. The marked findings are deleted inside Deploy (or the Quick Deploy of a validation), after the metadata succeeded and before the records are transferred. That deletion cannot be undone, and the screen says so before you press the button.
-
A target whose type Orgbench could not confirm still receives no records.
Pricing procedures and decision tables
- A version and the tables it reads, in one deployment. A decision table active in both the source and the target travels as inactive and is activated again after its row succeeded. The version is activated after its tables, and only when every table of the deployment that it reads is active; otherwise its row names the table. Validate only rewrites the statuses without activating anything, and a Quick Deploy of that validation activates as Deploy would.
- Several deployments when Salesforce needs them. A decision table the deployment rewrites to inactive goes in a deployment of its own whenever the selection carries any other row, and is activated again right after it (except in Validate only). A pricing recipe next to a procedure version also goes on its own, and the procedure versions go last. The review screen names what goes in each deployment and says that an earlier one stays in the target if a later one is refused.
- Removing an input column of a decision table. Salesforce refuses that while an active procedure version of the target reads the table. The review row names the column and the versions that read it, and Deploy first asks Switch off procedure versions?. On your confirmation those versions are switched off only for the table's own deployment and then switched on again by the running plugin. The confirmation names the expected window — about 15 seconds per table in a sandbox and about a minute in production, longer for each further version. Keep the IDE or VS Code open meanwhile: closing or reloading it then can leave a version switched off. A version is switched off only when Salesforce will switch it on again, and never for a managed package. Validate switches no version: the table is validated as it is, and its row says so.
- An existing version is never changed. A procedure version that already exists in an org target and differs from the source's cannot be selected. Its row says what to do: clone the version in the source and deploy the clone. A git target is not affected.
- Definitions travel as shells. A procedure definition deployed together with a selected version of it is sent without its nested versions, so the target keeps its own versions. This also holds when the definition differs from the target's outside its versions. A definition sent whole, without a selected version of it, leaves out the nested versions the target already has and names them on its row.
- Safer activation. A constraint model's version is activated only when its constraint model text reached the target. When a new version cannot be activated after the previous one was deactivated, the previous one is activated again. When an activation call answers with an error, Orgbench reads the target's versions again before deciding what to do next. The results screen counts
Not activated: Nversions. - Versions and statuses on the selection screen. The Expression Set Definitions entry lists each definition's versions with Version and Status columns, the latest on top.
Product Bundles and the Target health check
- Choose among duplicates. When a bundle record matches several records of the target, the Target health check shows a second table, Duplicates: choose the record this deploy updates. The bundle's records under the chosen one follow it. The other matches stay in the target untouched, and nothing is deleted. A record whose product type differs from the source's cannot be chosen, and its Note says why.
- A choice never moves silently. A choice that no longer matches is never replaced by another record. It is shown as Choice no longer matches before anything is sent, and the deploy refuses that record. Under a duplicate left without a choice, nothing changes.
- Check target. Next to Prepare Orgs, Check target checks the target's integrity before any comparison. It reads the 33 Revenue Cloud registry objects of the target, needs no source, and writes and deletes nothing. The findings list the broken references, with links to the records.
- When an object cannot be found in an org, the message names the likely causes — the feature is not licensed or not turned on, or the Salesforce CLI user cannot access it — and what to do.
Element-level merge
- Whether a page layout, Lightning page, report type or context definition is compared element by element is now decided for each document, by an Elements checkbox next to it on the selection screen. The Element-level merge setting is the starting value for a component you tick.
- Report Types can be merged column by column. A new column goes after its nearest neighbour from the source, and columns and sections that exist only in the target are never touched.
- Lightning Pages can be merged element by element: Dynamic Forms fields and components, and the page's assignments to apps, objects, record types and profiles. Each element is a row you can select. When Dynamic Forms would replace the Record Detail component of the target page, the row says so before you deploy.
- Context Definitions can be merged element by element. New nodes, attributes, tags and mappings are inserted into a fresh copy of the target's definition, and nothing in it is changed or removed. In both modes, when the target's definition is behind the source's, the row says beforehand that Salesforce's own sync will run and, when both orgs are on the same release, lists what it will add, change and remove.
Applications and their dependencies
- An application brings what it needs. Checking a custom application also checks the new Lightning pages it assigns or uses as its utility bar, its new custom tabs and the new record types its page assignments name. A tab of a new custom object also checks that object. Every one of those checks is visible and can be removed.
- Applications that the target accepts. A whole custom application sent to an org target leaves out the page assignments of profiles the target does not have, and sends an assignment the source repeats identically only once. The row names both changes.
- Managed package applications. They are now read by name. A page assignment inside one is shown, but cannot be selected, and its row says how to assign the page in the target.
- Person account record types. Page assignments to them are matched under the names Salesforce uses in each place. When the target lacks one, the row says what to do: turn person accounts on in the target, or create the record type there.
Results, Re-Deploy and New Comparison
- Re-Deploy. Check the
FailedandNot Attemptedrows on the results screen and deploy them again in the same mode, with the tests chosen for that deployment. A row the deployment already changed in the target cannot be checked, and its tooltip says why. - New Comparison keeps your marks. Rows, permission containers and Apex tests are carried to the next comparison, as if the session had been exported and imported.
- Rows with an error are listed first. Copying the details (Copy in IntelliJ, Copy details in VS Code) takes every component row, and only the permission rows that change the target or were meant to.
- Validate only says what a deployment would do, and Quick Deploy results carry the notes of their validation.
Everyday workflow
- Selected components. The selection screen opens on one table of everything you selected in the session, of every type.
- Diff window. The target is shown on the left and the source on the right by default. The Diff pane order setting (
orgbench.diffPaneOrderin VS Code) swaps them: Target left, source right (targetLeft) or Source left, target right (sourceLeft). - Faster comparisons. With two orgs, the target is retrieved in parallel with the source. Dependencies are followed only for the components your selection needs, and the progress line names each round.
- Read orgs through. A new setting (
orgbench.orgChannelin VS Code) chooses how Orgbench reads an org and sends the record writes of a bundle or model transfer: Salesforce CLI (sf) (cli), the default and the 0.1.4 behavior, or Salesforce API (faster) (api), which calls the APIs directly over HTTPS with the session the Salesforce CLI holds. That session is kept in memory only, and never reaches a log, a copy, a session file or the disk. - Fewer false differences. Formatting of the XML no longer counts as a difference for any document. Values that each org keeps for itself, such as the decision table IDs in procedure steps or the release version of a context definition, and the order of repeated blocks that Salesforce changes when it saves, are not reported either. The diff window still shows those values; for decision tables and context definitions it lays the target out in the source's order and says so in the title of the target pane.
- Custom fields are compared as whole documents. A difference in a description, help text, picklist values or the required flag now shows as
Definition changed. - Selected rows hidden by a filter are announced next to the deploy buttons, with a Show them link.
- Open in browser and Deployment Status. Both run the Salesforce CLI's own
sf org open. Orgbench never reads or logs its output, which carries a login URL with a session token. - Describe differences with Claude Code. Turn on the setting (
orgbench.describeWithClaudeCodein VS Code), then right-click a Flow, Apex class or Apex trigger row with statusUpdate. Only the two versions of that one component, as the diff window shows them, are handed to your own localclaude -p, which sends them to the model provider it is set up for (Anthropic by default). Nothing is sent until you choose the item, and the prompt and the answer never reach a log.
Permissions
- Permission Set repair mode (Best Effort). A new setting (
orgbench.permissionSetRepairModein VS Code) decides how Best Effort treats a Permission Set row against an org: Off (OFF) sends the document as is, with no retry; As now — trim and retry (up to 3) (TRIM_AND_RETRY), the default and the 0.1.4 behavior, trims it by what the target reports and retries up to three times; Target confirmed (TARGET_CONFIRMED) sends it as is first and retries only what the target named, up to four times. - History tracking stays with the target. The history and feed tracking settings of custom fields and custom objects no longer travel. An
Updatekeeps the target's settings, anAddis created with tracking off, and the row says when the source's setting differs. - A field that the Salesforce CLI user cannot see is no longer trimmed from a Permission Set, Profile or Context Definition.
Git repositories
- Deploying into a git repository now passes file paths to git on standard input, so very large deployments no longer meet the command-line length limit. This needs git 2.25 or later; an older git is detected before anything is written. Comparing against a repository needs git, but not this version.
- Before the first write, a deployment refuses a destination whose folder is a symbolic link or a file, and a path the repository ignores. Nothing is written then, and the message says what to change.
- A second deployment of the same session into a new
+branch adds one more commit to it. A+name that already belongs to another branch is refused, and so is a write after the checked-out branch was switched. - A branch whose name starts with
-is refused before git can read it as an option, and the message gives the command to rename it.
Changes in behavior since 0.1.4
- No Best Effort against production, and records there through Deploy. The Allow Best Effort against production (Revenue Cloud) setting (
orgbench.allowBestEffortOnProduction) was removed. In 0.1.4, records reached a production org only through Best Effort with that setting on. Now Deploy transfers product bundles and constraint models there as records and switches active versions, in phases (see above). - Deploy and Validate now handle pricing procedure versions too. In 0.1.4 only Best Effort sent a version that is active in the source as inactive and then switched the target's active version. Now, against an org whose type Orgbench confirmed, production included, every deploy mode sends such a version as inactive when the target runs another version as active; Deploy and Best Effort then switch the active version, and Validate only activates nothing. A decision table active in both the source and the target also travels as inactive in every mode and, except in Validate only, is activated again right after its deployment; one the source has inactive stays inactive, as in the source, and the review screen says so.
- Existing expression set versions are not updated against an org target. Clone the version in the source and deploy the clone.
- Data Cloud is not supported. The Marketing & Data Cloud category is no longer offered. Its four types — Analytics Dashboard, Analytics Visualization, Analytics Workspace and External Data Connector — left the type list. Data Cloud has its own way to move between orgs (Data Kits and Data Cloud packages). A saved setting that names the category still works; it just adds no types.
- The diff window shows the target on the left by default. Set Diff pane order to Source left, target right (
sourceLeft) for the old layout. - The selection screen opens on Selected components, with no metadata type picked.
- Page Layouts became Element-level merge. In VS Code,
orgbench.elementModereplacesorgbench.layoutMode, which is still read while the new key is not set. The setting now gives only the starting value of each document's Elements checkbox. - History tracking settings no longer travel, and a managed or standard field that used to be a Tracking only row is now a Permissions only row.
- Custom fields are compared as whole documents, so more of their changes show as
Definition changed. - Two new settings keep the 0.1.4 behavior by default: Permission Set repair mode is
TRIM_AND_RETRY(As now — trim and retry (up to 3) in IntelliJ), and Read orgs through is Salesforce CLI (sf) (cli). - Deploying into a git repository needs git 2.25 or later. Comparing against a repository needs git, but not this version; an older git is detected before anything is written.
- Tables. On the selection, container and results screens, the API Name column comes before Label. On the results screen, rows with an error come first.
Fixes
- Comparison. Decision tables, pricing procedure versions and context definitions no longer show as
Updatewhen they differ only in values each org writes for itself. A merge into a target with Windows line endings now keeps the target's line breaks. Orgbench no longer fails to start the Salesforce CLI whenFORCE_COLORis set in the environment. - Context Definitions. A node mapping that the mappings of its child nodes need is no longer cut. References to fields the Salesforce CLI user cannot access are kept.
- Sign-in and errors. An expired sign-in names the org by the alias you picked and points to the + button. A session the org rejects right after the Salesforce CLI refreshed it suggests switching Read orgs through to Salesforce CLI. A failed retrieve shows the cause the Salesforce CLI gave, and the error screen's heading names the cause when Orgbench knows it.
- Diagnostics. The sanitizer now also hides tokens with a prefixed name (such as
sfAccessToken), a bareBearertoken, a bare Salesforce session ID, a JWT and aforce://auth URL. - Results. The line explaining why Quick Deploy is missing is shown again when Salesforce answered
0 tests run. - IntelliJ. Compatibility fixes for IntelliJ platform 2026.3.
- VS Code. Importing a session restores the selection of its rows, and while an operation runs the table of differences ignores a double-click.
Requirements
- IntelliJ: IntelliJ IDEA 2024.2 or newer, or another IDE built on the IntelliJ platform.
- VS Code: VS Code 1.85 or newer. Install the VSIX for your platform:
orgbench-darwin-arm64.vsix,orgbench-darwin-x64.vsix,orgbench-win32-x64.vsixororgbench-linux-x64.vsix. - Platforms: macOS (Apple Silicon or Intel), Windows x64 or Linux x64. Linux on ARM is not supported.
- Salesforce CLI (
sf), installed and signed in to at least one org under an alias. - git 2.25 or later, only for deploying into a local git repository. Comparing against a repository needs git, but not this version.
- Claude Code (
claude), installed and signed in, only for Describe differences with Claude Code. - Product Bundles and Constraint Models need two orgs on Metadata API 67.0 or newer.
- Licensing: Orgbench is free during early access, and nothing is gated today. License checks are fully offline.
All files are on the downloads page. The IntelliJ and VS Code documentation cover the new production deployment, element-level merge and duplicate handling in full.