repo-manager CLI Reference

Use this reference to find the main repo-manager commands and options.

For the latest command output in your installed version, run:

repo-manager --help

Syntax

repo-manager [OPTIONS] [COMMAND]

Global Options

Option	Description
--auto-update	Trigger an update check immediately.
--no-auto-update	Suppress the update check for the current command.
-b, --backend=BACKEND	Set the API backend. Valid values: PRODUCTION, LOCAL. Default: PRODUCTION.
-c, --config=PATH	Set the configuration folder path. Default: .ca.
-r, --repository=PATH	Set the repository root path.
-h, --help	Show help and exit.
-V, --version	Print version information and exit.

Command Summary

Command	Purpose
auth	Manage authorization profiles.
env	Show information about the current environment.
docs	Manage auto-generated documentation from the repository.
policies	Work with Compliance Engine policies.
schema	Manage schema files in the repository.
ai	Generate context information for LLM workflows.
ui	Run the repo-manager UI.
soql	Convert SOQL queries to BigQuery SQL.
sections	Export framework sections.
types	Import or remove Salesforce SObject type data.
mcp	Start MCP servers.
gen-manpage	Generate AsciiDoc man pages.
cleanup	Remove generated and imported repository files.

Authentication Commands

Use auth commands to manage Cloudaware authorization profiles.

repo-manager auth [OPTIONS] [COMMAND]

auth add

Add a new authorization profile for connecting to Salesforce.

repo-manager auth add [OPTIONS]

Option	Description
-n, --name=NAME	Name of the profile to add.
-t, --token=TOKEN	OAuth token obtained from Cloudaware Admin.
-a, --active	Set the profile as active after creation.
--no-active	Add the profile without making it active.
-s, --sandbox	Configure the profile for a Salesforce sandbox org.
--no-sandbox	Configure the profile for a production Salesforce org.

auth activate

Set the active profile for subsequent commands.

repo-manager auth activate --name NAME

auth list

List configured authorization profiles.

repo-manager auth list

auth refresh-session

Refresh the current session for the active authorization profile.

repo-manager auth refresh-session

auth remove

Remove an authorization profile.

repo-manager auth remove --name NAME

Environment

Show information about the current environment.

repo-manager env

Documentation Commands

Use docs commands to generate or clean up repository documentation.

repo-manager docs [OPTIONS] [COMMAND]

docs generate

Generate documentation for the repository.

repo-manager docs generate [OPTIONS]

Option	Description
-f, --format=<arg1>	Output format. Valid values: MD, MDX.
-r, --renderer=<arg2>	Documentation renderer. Valid values: NONE, CLOUDAWARE, DOCUSAURUS.
-t, --threads=<arg3>	Number of worker threads. Default: CPU_COUNT/2.
-w, --watch	Watch the repository and update generated documentation when files change.

docs cleanup

Remove generated documentation files from the repository.

repo-manager docs cleanup

Policy Commands

Use policies commands to generate scripts, run tests, evaluate objects, capture test data, and import policy statistics.

repo-manager policies [OPTIONS] [COMMAND]

policies generate

Generate a BigQuery script for a policy.

repo-manager policies generate <kind> <id>

Argument	Description
kind	Script kind. Valid values: FULL, DEBUG, CAPTURE_TEST_DATA, TESTS.
id	Policy ID or Logic ID.

policies test

Run tests for a policy, logic item, folder, all policies, or unit tests.

repo-manager policies test [OPTIONS] <id>

Option or Argument	Description
--format=<arg1>	Output format. Valid values: NONE, JUNIT.
--output-dir=<arg2>	Output directory for reports. Default for JUNIT: REPO/target/surefire-reports.
-t, --threads=<arg3>	Number of worker threads. Default: 1; maximum: 5.
id	Policy ID/path, Logic ID/path, folder ID/path, all, or unit-tests.

policies capture-test-data

Capture test-data.json for a policy from data available in Cloudaware.

repo-manager policies capture-test-data [OPTIONS] <id>

Option or Argument	Description
-o, --output-file=PATH	Output file path. Default: POLICY_DIR/test-data.json.
id	Policy ID/path or Logic ID/path.

policies evaluate-object

Evaluate one Cloudaware object against one policy.

repo-manager policies evaluate-object [OPTIONS] <id> <caUuid>

Option or Argument	Description
-e, --execute	Execute the received script immediately. Default: false.
-c, --command=<arg3>	Command used for immediate execution. Default: node.
-w, --wrapper=<arg4>	Wrapper for the received script. Use __CONTENT__ to substitute script content.
id	Policy ID/path or Logic ID/path.
caUuid	Cloudaware UUID of the object to test.

policies import-stats

Import statistics for the latest policy runs into a file.

repo-manager policies import-stats

Schema Commands

Use schema commands to manage schema files in the repository.

repo-manager schema [OPTIONS] [COMMAND]

schema update

Update repository schema files.

repo-manager schema update

AI Commands

Use ai commands to generate context information for LLM-based workflows.

repo-manager ai [OPTIONS] [COMMAND]

ai context generate

Generate context information for LLMs.

repo-manager ai context generate [OPTIONS]

Option	Description
-o, --output-directory=PATH	Output directory. Default: tmp/llm-context.

SOQL Commands

Use soql commands to convert SOQL queries into BigQuery SQL.

repo-manager soql [OPTIONS] [COMMAND]

soql convert

Convert a SOQL query.

repo-manager soql convert [OPTIONS] queryText

Option or Argument	Description
-i, --input-file=<arg0>	Input file containing the SOQL query.
-o, --output-file=<arg1>	Output file for the converted query.
queryText	SOQL query text to convert.

Section Commands

Use sections commands to export framework sections.

repo-manager sections [OPTIONS] [COMMAND]

sections export

Export framework sections to a file.

repo-manager sections export [OPTIONS]

Option	Description
-f, --format=FORMAT	Export format. Supported formats include DEFAULT_CSV, EXCEL, JSONL, BIGQUERY, RFC4180, TDF, and database-specific CSV or text formats.
-o, --output-directory=PATH	Output directory. Default: tmp.

Type Commands

Use types commands to import or remove Salesforce SObject type data.

repo-manager types [OPTIONS] [COMMAND]

types import

Import Salesforce SObject type data.

repo-manager types import [OPTIONS]

Option	Description
-p, --preset=PRESET	Import one or more presets. Valid values: REFERENCED, CLOUDAWARE, STANDARD, EXTRA.
-t, --type=TYPE	Salesforce type API name to import. Can be specified multiple times.
--exclude-custom-fields	Exclude custom fields from imported types.
--exclude-custom-types	Exclude custom types from imported types.

types delete

Remove imported Salesforce SObject type data.

repo-manager types delete

MCP Commands

Use mcp commands to start MCP servers for AI tools.

repo-manager mcp [OPTIONS] [COMMAND]

mcp cloudaware

Start the Cloudaware MCP server with stdio transport.

repo-manager mcp cloudaware [OPTIONS]

Option	Description
-p, --port=<arg0>	Start an HTTP server on the specified port. If this option is omitted, the server starts with stdio transport.

UI

Run the repo-manager UI.

repo-manager ui

Man Page Generation

Generate AsciiDoc man pages for repo-manager commands.

repo-manager gen-manpage [OPTIONS] [@<filename>...]

Option or Argument	Description
-d, --outdir=<outdir>	Directory where generated AsciiDoc files are written. If omitted, files are written to the current directory.
-t, --template-dir=<template-dir>	Directory for customizable man page template files.
-f, --force	Overwrite existing man page templates.
--no-force	Do not overwrite existing templates. This is the default behavior.
-v, --verbose	Increase verbosity. Can be specified multiple times.
@<filename>...	One or more argument files containing options.

To convert generated AsciiDoc files to man page format, use asciidoctor:

asciidoctor --backend=manpage --source-dir=SOURCE_DIR --destination-dir=DESTINATION *.adoc

Cleanup

Remove generated and imported files and directories from the repository.

repo-manager cleanup