IAPL - SFInspector
Salesforce Inspector-like extension for VS Code / Cursor. No runtime dependencies, no build step.
It uses the orgs you already authenticated with Salesforce CLI (sf org login web) and talks to Salesforce through the
@salesforce/core library bundled with the CLI (a helper process, worker.js). The extension never reads tokens.
Install
Install the VSIX: Ctrl+Shift+P -> Extensions: Install from VSIX... (build it with npx @vscode/vsce package).
The left menu follows the Salesforce Inspector popup: Objects / Users / Shortcuts / Org on top, then
Data & Metadata, Platform Tools and Management. Alt+1 ... Alt+0 jump to the pages in menu order.
Data & Metadata
- Data Export - several query tabs (rename with double click, drag to reorder, right-click menu, remembered between
sessions). SOQL and SOSL (
FIND {...}), autocomplete (fields from the org and the repo's *.field-meta.xml,
relationships, subqueries, picklist values; Ctrl+Space between SELECT and FROM inserts every field; Ctrl+Space inside a text filter such as Username = 'And lists the values that really exist in the org), query plan
(Explain), history, templates (built-in + your own), saved queries (per project or global, filterable by object),
clicking an Id offers Show all data / Open in Salesforce, results with sort / filter / column selector, inline editing (double click cells, edit many records, one Save edits button; Ctrl + double click copies a cell), / column reordering / local time, row as JSON, copy a column as
IN ('a','b'), export CSV / Excel / JSON, EventLogFile download, send rows to Import or delete them,
and Export all (Bulk) for large exports straight to a file.
- Data Import (live view of pending / processing / success / failed while it runs) - paste or load CSV / TSV / JSON / Excel, map columns, preview, then insert / update / upsert / delete
(batch size, threads, assignment rules, duplicate-rule bypass, custom headers, per-row results, retry failed rows),
or Bulk API 2.0 for large loads.
- Record Viewer - view and edit any record by Id (picklists are dropdowns), related records, recently viewed, back button, delete.
- Logs Viewer - filter by user and date, paging, bulk delete, download, grep templates, search with highlight,
search inside the loaded logs.
- Dependencies Explorer - what uses a component and what it needs (summary, tree, JSON, package.xml text).
- Create Translation - builds the
.stf for Translation Workbench from the org: choose the language, an object, then the fields (label, help text) and the custom picklist values to translate with the same predictor as the queries (org + repo), the translations that already exist in the org for the language are shown (Metadata API read) and only new or changed ones go into the file; save it ready to import. Standard picklists and Global Value Sets use other keys and are not covered yet.
- Flow Tools - flows and versions, purge old versions (never the active one), Flow Scanner with 11 switchable rules.
Platform Tools: Org Limits (gauges), API Statistics (calls made by the extension), REST Explorer
(templates, headers, history, GraphQL, formatted responses), Apex Console, Event Monitor (platform events and
change data capture with replay).
Management: Login as, Setup Home, Options.
Top pages: Objects (omnibox for record Id / id prefix / object name, Setup links, field usage),
Users (search with history and saved lists such as "test users" = test.user+%, actions on every user of the result: debug logs, assign a permission set, copy usernames / Ids; Login as, debug log, activate, unfreeze, reset password, locale, permission sets),
Shortcuts (Setup links, metadata search, custom shortcuts), Org (info, maintenance).
More
- Query results: Copy CSV, Copy as Apex (insert), Clone -> Import, Pin result + Compare (by Id), floating header while scrolling,
editable lookup columns (
Owner.Name searches the related record and saves OwnerId).
- Record Viewer: chips for the records opened in the session (click to switch, x to close).
- Favorites: star objects, records and Setup shortcuts; they are listed on top of the Shortcuts page.
- Org -> Export my settings / Import settings: saved queries, shortcuts, user lists, favorites, REST requests and disabled flow rules in one JSON file.
Login as
Opens a private browser window (no confirmation, not even on production) (Chrome, Edge, Firefox or Brave) signed in with a one-time link, so your normal
session is not replaced. Set sfInspector.loginAsMode to normal to use the default browser instead (needs an admin
session there). You must be allowed to log in as users; it is recorded in the audit trail.
Safety
- The selected org is marked [PROD] with a red banner when it is production.
- Anything that changes data is confirmed by the extension host: on production you must type the org name;
on other orgs imports, deletes, user changes and debug-log changes ask for confirmation.
- Imports are limited by
sfInspector.maxImportRows / maxBulkRows; the Run button locks after each run.
Editor integration
.soql files: Run and Save query CodeLens above each query. .apex files: Open in SFInspector Apex.
- Right-click a selection: Run Selected SOQL / Send Selection to Apex.
- Commands:
IAPL - SFInspector: Open, Login As..., Run Selected SOQL, Inspect Selected Record Id, Send Selection to Apex.
- Query results are a virtual table: only the rows near the viewport exist in the page, so 10,000+ rows scroll, sort
and filter instantly. Filtered / sorted rows are computed once and reused by the exports.
- The list of orgs, the object list and every object's describe are kept on disk (compressed, in the extension's
storage) and refreshed in the background, so a new session is usable at once. Org -> Clear cache deletes them.
The helper process and the connection of the selected org start while the page loads.
Tests
test/ holds integration tests that run the real extension host, helper process and page scripts (jsdom) against a
fake Salesforce. They are not part of the VSIX: cd test && npm install && node run-all.js.
Settings
sfInspector.defaultOrg, maxRows, maxImportRows, maxBulkRows, bulkPageSize, importBatchSize,
importConcurrency, csvSeparator, convertToLocalTime, queryTemplates, excludeFormulasFromAutocomplete,
queryBatchSize, apiVersion, debugLevel, debugLogMinutes, loginAsMode, browserPath, openMode, and the advanced
sfCommand, coreModulePath, nodePath. See NOTICE.md for credits.
| |