@evan-hyer/track-changes
v1.0.0
Published
Salesforce CLI plugin to track metadata changes.
Readme
track-changes
Salesforce CLI plugin to track metadata changes.
Quick Start
# Install globally
npm install -g @evan-hyer/track-changes
# See all metadata changes in your default org
track-changes
# Filter by user
track-changes --user "John Doe"
# Export to JSON (pipe to jq, scripts, etc.)
track-changes --output json
# Generate HTML report
track-changes --output html --out-file changes.htmlOutput formats:
| Format | Flag | Use Case |
|--------|------|----------|
| Table | --output table (default) | Quick terminal scan |
| JSON | --output json | Scripting, CI/CD |
| HTML | --output html | Sharing, documentation |
- Install globally
- See all metadata changes in your default org
- Filter by user
- Export to JSON (pipe to jq, scripts, etc.)
- Generate HTML report
- Usage
- Commands
- Install globally
- See all metadata changes in your default org
- Filter by user
- Export to JSON (pipe to jq, scripts, etc.)
- Generate HTML report
- Usage
- Commands
Usage
$ npm install -g @evan-hyer/track-changes
$ track-changes COMMAND
running command...
$ track-changes (--version)
@evan-hyer/track-changes/1.0.0 win32-x64 node-v24.12.0
$ track-changes --help [COMMAND]
USAGE
$ track-changes COMMAND
...$ npm install -g @evan-hyer/track-changes
$ track-changes COMMAND
running command...
$ track-changes (--version)
@evan-hyer/track-changes/1.0.0 linux-x64 node-v25.6.0
$ track-changes --help [COMMAND]
USAGE
$ track-changes COMMAND
...Commands
track-changestrack-changes committrack-changes commit-changestrack-changes help [COMMAND]track-changes pluginstrack-changes plugins add PLUGINtrack-changes plugins:inspect PLUGIN...track-changes plugins install PLUGINtrack-changes plugins link PATHtrack-changes plugins remove [PLUGIN]track-changes plugins resettrack-changes plugins uninstall [PLUGIN]track-changes plugins unlink [PLUGIN]track-changes plugins updatetrack-changes retrievetrack-changes selecttrack-changes track
track-changes
Track changes in a Salesforce org
USAGE
$ track-changes [--debug] [-l <value>] [-n <value>] [-f <value>] [-o table|json|html] [-s <value>]
[-t <value>] [-m <value>] [-e <value>] [-u <value>]
FLAGS
-e, --until=<value> Filter changes until this date (YYYY-MM-DD)
-f, --out-file=<value> Output filename for HTML report
-l, --limit=<value> Limit the number of results to display
-m, --type=<value> Filter by member type (comma-separated)
-n, --name=<value> Filter by component name (allows % wildcard)
-o, --output=<option> [default: table] Output format
<options: table|json|html>
-s, --since=<value> Filter changes since this date (YYYY-MM-DD)
-t, --target-org=<value> The alias or username of the org to track changes in
-u, --user=<value> Filter changes by the user who made them
--debug Show debug output
DESCRIPTION
Track changes in a Salesforce org
ALIASES
$ track-changestrack-changes commit
Commit changes to Git
USAGE
$ track-changes commit -m <value> [-a]
FLAGS
-a, --all Stage all changes before committing
-m, --message=<value> (required) Commit message
DESCRIPTION
Commit changes to GitSee code: src/commands/commit.ts
track-changes commit-changes
Orchestrate selection, retrieval, and commitment of metadata
USAGE
$ track-changes commit-changes [-m <value>] [-t <value>] [--type <value>]
FLAGS
-m, --message=<value> Commit message
-t, --target-org=<value> The alias or username of the org
--type=<value> Filter by member type (comma-separated)
DESCRIPTION
Orchestrate selection, retrieval, and commitment of metadataSee code: src/commands/commit-changes.ts
track-changes help [COMMAND]
Display help for track-changes.
USAGE
$ track-changes help [COMMAND...] [-n]
ARGUMENTS
[COMMAND...] Command to show help for.
FLAGS
-n, --nested-commands Include all nested commands in the output.
DESCRIPTION
Display help for track-changes.See code: @oclif/plugin-help
track-changes plugins
List installed plugins.
USAGE
$ track-changes plugins [--json] [--core]
FLAGS
--core Show core plugins.
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
List installed plugins.
EXAMPLES
$ track-changes pluginsSee code: @oclif/plugin-plugins
track-changes plugins add PLUGIN
Installs a plugin into track-changes.
USAGE
$ track-changes plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
ARGUMENTS
PLUGIN... Plugin to install.
FLAGS
-f, --force Force npm to fetch remote resources even if a local copy exists on disk.
-h, --help Show CLI help.
-s, --silent Silences npm output.
-v, --verbose Show verbose npm output.
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Installs a plugin into track-changes.
Uses npm to install plugins.
Installation of a user-installed plugin will override a core plugin.
Use the TRACK_CHANGES_NPM_LOG_LEVEL environment variable to set the npm loglevel.
Use the TRACK_CHANGES_NPM_REGISTRY environment variable to set the npm registry.
ALIASES
$ track-changes plugins add
EXAMPLES
Install a plugin from npm registry.
$ track-changes plugins add myplugin
Install a plugin from a github url.
$ track-changes plugins add https://github.com/someuser/someplugin
Install a plugin from a github slug.
$ track-changes plugins add someuser/someplugintrack-changes plugins:inspect PLUGIN...
Displays installation properties of a plugin.
USAGE
$ track-changes plugins inspect PLUGIN...
ARGUMENTS
PLUGIN... [default: .] Plugin to inspect.
FLAGS
-h, --help Show CLI help.
-v, --verbose
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Displays installation properties of a plugin.
EXAMPLES
$ track-changes plugins inspect mypluginSee code: @oclif/plugin-plugins
track-changes plugins install PLUGIN
Installs a plugin into track-changes.
USAGE
$ track-changes plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
ARGUMENTS
PLUGIN... Plugin to install.
FLAGS
-f, --force Force npm to fetch remote resources even if a local copy exists on disk.
-h, --help Show CLI help.
-s, --silent Silences npm output.
-v, --verbose Show verbose npm output.
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Installs a plugin into track-changes.
Uses npm to install plugins.
Installation of a user-installed plugin will override a core plugin.
Use the TRACK_CHANGES_NPM_LOG_LEVEL environment variable to set the npm loglevel.
Use the TRACK_CHANGES_NPM_REGISTRY environment variable to set the npm registry.
ALIASES
$ track-changes plugins add
EXAMPLES
Install a plugin from npm registry.
$ track-changes plugins install myplugin
Install a plugin from a github url.
$ track-changes plugins install https://github.com/someuser/someplugin
Install a plugin from a github slug.
$ track-changes plugins install someuser/somepluginSee code: @oclif/plugin-plugins
track-changes plugins link PATH
Links a plugin into the CLI for development.
USAGE
$ track-changes plugins link PATH [-h] [--install] [-v]
ARGUMENTS
PATH [default: .] path to plugin
FLAGS
-h, --help Show CLI help.
-v, --verbose
--[no-]install Install dependencies after linking the plugin.
DESCRIPTION
Links a plugin into the CLI for development.
Installation of a linked plugin will override a user-installed or core plugin.
e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
command will override the user-installed or core plugin implementation. This is useful for development work.
EXAMPLES
$ track-changes plugins link mypluginSee code: @oclif/plugin-plugins
track-changes plugins remove [PLUGIN]
Removes a plugin from the CLI.
USAGE
$ track-changes plugins remove [PLUGIN...] [-h] [-v]
ARGUMENTS
[PLUGIN...] plugin to uninstall
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Removes a plugin from the CLI.
ALIASES
$ track-changes plugins unlink
$ track-changes plugins remove
EXAMPLES
$ track-changes plugins remove myplugintrack-changes plugins reset
Remove all user-installed and linked plugins.
USAGE
$ track-changes plugins reset [--hard] [--reinstall]
FLAGS
--hard Delete node_modules and package manager related files in addition to uninstalling plugins.
--reinstall Reinstall all plugins after uninstalling.See code: @oclif/plugin-plugins
track-changes plugins uninstall [PLUGIN]
Removes a plugin from the CLI.
USAGE
$ track-changes plugins uninstall [PLUGIN...] [-h] [-v]
ARGUMENTS
[PLUGIN...] plugin to uninstall
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Removes a plugin from the CLI.
ALIASES
$ track-changes plugins unlink
$ track-changes plugins remove
EXAMPLES
$ track-changes plugins uninstall mypluginSee code: @oclif/plugin-plugins
track-changes plugins unlink [PLUGIN]
Removes a plugin from the CLI.
USAGE
$ track-changes plugins unlink [PLUGIN...] [-h] [-v]
ARGUMENTS
[PLUGIN...] plugin to uninstall
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Removes a plugin from the CLI.
ALIASES
$ track-changes plugins unlink
$ track-changes plugins remove
EXAMPLES
$ track-changes plugins unlink myplugintrack-changes plugins update
Update installed plugins.
USAGE
$ track-changes plugins update [-h] [-v]
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Update installed plugins.See code: @oclif/plugin-plugins
track-changes retrieve
Retrieve selected metadata from Salesforce
USAGE
$ track-changes retrieve -s <value> [-r <value>] [-t <value>]
FLAGS
-r, --output-dir=<value> Output directory for retrieved metadata
-s, --selections=<value> (required) Path to selection JSON file
-t, --target-org=<value> The alias or username of the org to retrieve from
DESCRIPTION
Retrieve selected metadata from SalesforceSee code: src/commands/retrieve.ts
track-changes select
Select metadata for commit
USAGE
$ track-changes select [-i] [-o <value>] [-t <value>] [-m <value>]
FLAGS
-i, --[no-]interactive Enable interactive selection mode
-m, --type=<value> Filter by member type (comma-separated)
-o, --output=<value> Output file path for selection (JSON)
-t, --target-org=<value> The alias or username of the org to select metadata from
DESCRIPTION
Select metadata for commitSee code: src/commands/select.ts
track-changes track
Track changes in a Salesforce org
USAGE
$ track-changes track [--debug] [-l <value>] [-n <value>] [-f <value>] [-o table|json|html] [-s <value>]
[-t <value>] [-m <value>] [-e <value>] [-u <value>]
FLAGS
-e, --until=<value> Filter changes until this date (YYYY-MM-DD)
-f, --out-file=<value> Output filename for HTML report
-l, --limit=<value> Limit the number of results to display
-m, --type=<value> Filter by member type (comma-separated)
-n, --name=<value> Filter by component name (allows % wildcard)
-o, --output=<option> [default: table] Output format
<options: table|json|html>
-s, --since=<value> Filter changes since this date (YYYY-MM-DD)
-t, --target-org=<value> The alias or username of the org to track changes in
-u, --user=<value> Filter changes by the user who made them
--debug Show debug output
DESCRIPTION
Track changes in a Salesforce org
ALIASES
$ track-changesSee code: src/commands/track.ts
track-changestrack-changes committrack-changes commit-changestrack-changes help [COMMAND]track-changes pluginstrack-changes plugins add PLUGINtrack-changes plugins:inspect PLUGIN...track-changes plugins install PLUGINtrack-changes plugins link PATHtrack-changes plugins remove [PLUGIN]track-changes plugins resettrack-changes plugins uninstall [PLUGIN]track-changes plugins unlink [PLUGIN]track-changes plugins updatetrack-changes retrievetrack-changes selecttrack-changes track
track-changes
Track changes in a Salesforce org
USAGE
$ track-changes [--debug] [-l <value>] [-n <value>] [-f <value>] [-o table|json|html] [-s <value>]
[-t <value>] [-m <value>] [-e <value>] [-u <value>]
FLAGS
-e, --until=<value> Filter changes until this date (YYYY-MM-DD)
-f, --out-file=<value> Output filename for HTML report
-l, --limit=<value> Limit the number of results to display
-m, --type=<value> Filter by member type (comma-separated)
-n, --name=<value> Filter by component name (allows % wildcard)
-o, --output=<option> [default: table] Output format
<options: table|json|html>
-s, --since=<value> Filter changes since this date (YYYY-MM-DD)
-t, --target-org=<value> The alias or username of the org to track changes in
-u, --user=<value> Filter changes by the user who made them
--debug Show debug output
DESCRIPTION
Track changes in a Salesforce org
ALIASES
$ track-changestrack-changes commit
Commit changes to Git
USAGE
$ track-changes commit -m <value> [-a]
FLAGS
-a, --all Stage all changes before committing
-m, --message=<value> (required) Commit message
DESCRIPTION
Commit changes to GitSee code: src/commands/commit.ts
track-changes commit-changes
Orchestrate selection, retrieval, and commitment of metadata
USAGE
$ track-changes commit-changes [-m <value>] [-t <value>] [--type <value>]
FLAGS
-m, --message=<value> Commit message
-t, --target-org=<value> The alias or username of the org
--type=<value> Filter by member type (comma-separated)
DESCRIPTION
Orchestrate selection, retrieval, and commitment of metadataSee code: src/commands/commit-changes.ts
track-changes help [COMMAND]
Display help for track-changes.
USAGE
$ track-changes help [COMMAND...] [-n]
ARGUMENTS
[COMMAND...] Command to show help for.
FLAGS
-n, --nested-commands Include all nested commands in the output.
DESCRIPTION
Display help for track-changes.See code: @oclif/plugin-help
track-changes plugins
List installed plugins.
USAGE
$ track-changes plugins [--json] [--core]
FLAGS
--core Show core plugins.
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
List installed plugins.
EXAMPLES
$ track-changes pluginsSee code: @oclif/plugin-plugins
track-changes plugins add PLUGIN
Installs a plugin into track-changes.
USAGE
$ track-changes plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
ARGUMENTS
PLUGIN... Plugin to install.
FLAGS
-f, --force Force npm to fetch remote resources even if a local copy exists on disk.
-h, --help Show CLI help.
-s, --silent Silences npm output.
-v, --verbose Show verbose npm output.
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Installs a plugin into track-changes.
Uses npm to install plugins.
Installation of a user-installed plugin will override a core plugin.
Use the TRACK_CHANGES_NPM_LOG_LEVEL environment variable to set the npm loglevel.
Use the TRACK_CHANGES_NPM_REGISTRY environment variable to set the npm registry.
ALIASES
$ track-changes plugins add
EXAMPLES
Install a plugin from npm registry.
$ track-changes plugins add myplugin
Install a plugin from a github url.
$ track-changes plugins add https://github.com/someuser/someplugin
Install a plugin from a github slug.
$ track-changes plugins add someuser/someplugintrack-changes plugins:inspect PLUGIN...
Displays installation properties of a plugin.
USAGE
$ track-changes plugins inspect PLUGIN...
ARGUMENTS
PLUGIN... [default: .] Plugin to inspect.
FLAGS
-h, --help Show CLI help.
-v, --verbose
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Displays installation properties of a plugin.
EXAMPLES
$ track-changes plugins inspect mypluginSee code: @oclif/plugin-plugins
track-changes plugins install PLUGIN
Installs a plugin into track-changes.
USAGE
$ track-changes plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
ARGUMENTS
PLUGIN... Plugin to install.
FLAGS
-f, --force Force npm to fetch remote resources even if a local copy exists on disk.
-h, --help Show CLI help.
-s, --silent Silences npm output.
-v, --verbose Show verbose npm output.
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Installs a plugin into track-changes.
Uses npm to install plugins.
Installation of a user-installed plugin will override a core plugin.
Use the TRACK_CHANGES_NPM_LOG_LEVEL environment variable to set the npm loglevel.
Use the TRACK_CHANGES_NPM_REGISTRY environment variable to set the npm registry.
ALIASES
$ track-changes plugins add
EXAMPLES
Install a plugin from npm registry.
$ track-changes plugins install myplugin
Install a plugin from a github url.
$ track-changes plugins install https://github.com/someuser/someplugin
Install a plugin from a github slug.
$ track-changes plugins install someuser/somepluginSee code: @oclif/plugin-plugins
track-changes plugins link PATH
Links a plugin into the CLI for development.
USAGE
$ track-changes plugins link PATH [-h] [--install] [-v]
ARGUMENTS
PATH [default: .] path to plugin
FLAGS
-h, --help Show CLI help.
-v, --verbose
--[no-]install Install dependencies after linking the plugin.
DESCRIPTION
Links a plugin into the CLI for development.
Installation of a linked plugin will override a user-installed or core plugin.
e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
command will override the user-installed or core plugin implementation. This is useful for development work.
EXAMPLES
$ track-changes plugins link mypluginSee code: @oclif/plugin-plugins
track-changes plugins remove [PLUGIN]
Removes a plugin from the CLI.
USAGE
$ track-changes plugins remove [PLUGIN...] [-h] [-v]
ARGUMENTS
[PLUGIN...] plugin to uninstall
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Removes a plugin from the CLI.
ALIASES
$ track-changes plugins unlink
$ track-changes plugins remove
EXAMPLES
$ track-changes plugins remove myplugintrack-changes plugins reset
Remove all user-installed and linked plugins.
USAGE
$ track-changes plugins reset [--hard] [--reinstall]
FLAGS
--hard Delete node_modules and package manager related files in addition to uninstalling plugins.
--reinstall Reinstall all plugins after uninstalling.See code: @oclif/plugin-plugins
track-changes plugins uninstall [PLUGIN]
Removes a plugin from the CLI.
USAGE
$ track-changes plugins uninstall [PLUGIN...] [-h] [-v]
ARGUMENTS
[PLUGIN...] plugin to uninstall
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Removes a plugin from the CLI.
ALIASES
$ track-changes plugins unlink
$ track-changes plugins remove
EXAMPLES
$ track-changes plugins uninstall mypluginSee code: @oclif/plugin-plugins
track-changes plugins unlink [PLUGIN]
Removes a plugin from the CLI.
USAGE
$ track-changes plugins unlink [PLUGIN...] [-h] [-v]
ARGUMENTS
[PLUGIN...] plugin to uninstall
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Removes a plugin from the CLI.
ALIASES
$ track-changes plugins unlink
$ track-changes plugins remove
EXAMPLES
$ track-changes plugins unlink myplugintrack-changes plugins update
Update installed plugins.
USAGE
$ track-changes plugins update [-h] [-v]
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Update installed plugins.See code: @oclif/plugin-plugins
track-changes retrieve
Retrieve selected metadata from Salesforce
USAGE
$ track-changes retrieve -s <value> [-r <value>] [-t <value>]
FLAGS
-r, --output-dir=<value> Output directory for retrieved metadata
-s, --selections=<value> (required) Path to selection JSON file
-t, --target-org=<value> The alias or username of the org to retrieve from
DESCRIPTION
Retrieve selected metadata from SalesforceSee code: src/commands/retrieve.ts
track-changes select
Select metadata for commit
USAGE
$ track-changes select [-i] [-o <value>] [-t <value>] [-m <value>]
FLAGS
-i, --[no-]interactive Enable interactive selection mode
-m, --type=<value> Filter by member type (comma-separated)
-o, --output=<value> Output file path for selection (JSON)
-t, --target-org=<value> The alias or username of the org to select metadata from
DESCRIPTION
Select metadata for commitSee code: src/commands/select.ts
track-changes track
Track changes in a Salesforce org
USAGE
$ track-changes track [--debug] [-l <value>] [-n <value>] [-f <value>] [-o table|json|html] [-s <value>]
[-t <value>] [-m <value>] [-e <value>] [-u <value>]
FLAGS
-e, --until=<value> Filter changes until this date (YYYY-MM-DD)
-f, --out-file=<value> Output filename for HTML report
-l, --limit=<value> Limit the number of results to display
-m, --type=<value> Filter by member type (comma-separated)
-n, --name=<value> Filter by component name (allows % wildcard)
-o, --output=<option> [default: table] Output format
<options: table|json|html>
-s, --since=<value> Filter changes since this date (YYYY-MM-DD)
-t, --target-org=<value> The alias or username of the org to track changes in
-u, --user=<value> Filter changes by the user who made them
--debug Show debug output
DESCRIPTION
Track changes in a Salesforce org
ALIASES
$ track-changesSee code: src/commands/track.ts
