otty / apps

All apps/CumulusCI

CumulusCI

cumulusci

Build great applications on the Salesforce platform by automating org setup, testing, and deployment.

Runs as cci|macOS, Linux, Windows|cumulusci.readthedocs.io

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

CumulusCI in your home directory Every rule on this page, by file

· cumulusci.yml Sync

· orginfo/ Exclude

· *.org Never synced

· */*.org Never synced

· services/*/*.service Never synced

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/cumulusci/otty.tomlThe file this page is generated from

id = "cumulusci"

name = "CumulusCI"

homepage = "https://cumulusci.readthedocs.io"

description = "Build great applications on the Salesforce platform by automating org setup, testing, and deployment."

executables = ["cci"]

[dotfiles]

# https://github.com/SFDO-Tooling/CumulusCI/blob/main/docs/config.md — the

# global config file is ~/.cumulusci/cumulusci.yml. The directory itself is

# built in cumulusci/core/config/universal_config.py as

# `config_dir = Path.home() / ".cumulusci"`.

paths = ["~/.cumulusci/cumulusci.yml"]

# orginfo/ is a cache of org descriptions the keychain re-fetches; see

# `(self.global_config_dir / "orginfo").glob("*")` in

# cumulusci/core/keychain/encrypted_file_project_keychain.py.

exclude = ["~/.cumulusci/orginfo/"]

# The same file, on the layout: "Service files (.service) are organized under

# ~/.cumulusci/services/ into sub-directories … Org files (.org) live in both

# under ~/.cumulusci and in local project directories. The .org files store an

# encrypted access_token and other org attributes." Encrypted with a key

# derived from CUMULUSCI_KEY, so the file alone is still the credential.

secret = [

"~/.cumulusci/*.org",

"~/.cumulusci/*/*.org",

"~/.cumulusci/services/*/*.service",

]

# No machine_lines: the global cumulusci.yml holds task and flow defaults that

# are meant to follow the developer, and nothing in it names this machine.

[commands]

format = 1

label = "CumulusCI"

description = "Run CumulusCI flows and tasks."

quality = "ai-draft"

base = "fig:cci"

parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/cci.ts"

license = "MIT"

[[commands.subcommand]]

path = ["flow", "run"]

label = "Run a flow"

description = "Run a named flow against an org."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/cci.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "flow"

label = "Flow name"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "org"

label = "Target org"

description = "Defaults to the current default org."

type = "string"

option = ["--org"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "delete_org"

label = "Delete scratch org afterwards"

type = "boolean"

option = ["--delete-org"]

effect = "delete"

sources = ["fig"]

[[commands.subcommand.field]]

id = "task_option"

label = "Task options"

description = "Written as taskname__option value; repeat for more than one."

type = "string"

option = ["-o"]

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "no_prompt"

label = "Non-interactive"

type = "boolean"

option = ["--no-prompt"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "debug"

label = "Debug on exception"

type = "boolean"

option = ["--debug"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "run"

label = "Run a flow"

fields = ["flow", "org", "no_prompt"]

required = ["flow"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["flow", "org", "task_option"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["delete_org", "no_prompt", "debug"]

[[commands.subcommand]]

path = ["task", "run"]

label = "Run a task"

description = "Run a named task for the current project."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/cci.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "task"

label = "Task name"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.task]]

id = "run"

label = "Run a task"

fields = ["task"]

required = ["task"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["task"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/cumulusci. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps all credential files out.