otty / apps

All apps/Commerce Layer CLI

Commerce Layer CLI

commercelayer

The official Commerce Layer CLI which helps you to manage your Commerce Layer applications right from the terminal.

Runs as commercelayer, clayer|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

Commerce Layer CLI in your home directory Every rule on this page, by file

· ~/.config/@commercelayer/cli/applications/ Never synced

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

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

id = "commercelayer"

name = "Commerce Layer CLI"

homepage = "https://github.com/commercelayer/commercelayer-cli"

description = "The official Commerce Layer CLI which helps you to manage your Commerce Layer applications right from the terminal."

# Commerce Layer's mark, the SVG favicon its own site serves.

icon = "https://commercelayer.io/favicon.svg"

# `commercelayer` and `clayer` are two of the three bin names in package.json.

# The third, `cl`, is deliberately left out: it is also the name of the MSVC

# compiler driver, and a consumer that mapped `cl` to this entry would be wrong

# on every Windows machine that builds C++.

executables = ["commercelayer", "clayer"]

[dotfiles]

# Nothing here is ordinary config. The CLI's own settings file (the configstore

# at ~/.config/@commercelayer/cli/config.json) holds which application is

# currently selected plus two knobs — `test` and `commandRetention` — which is

# selection state, not something a user carries between machines.

paths = []

exclude = []

# Every file in the applications directory is a credential.

# src/config.ts writes two per logged-in application, both under

# `join(config.configDir, 'applications')`:

# <key>.config.json — the AppInfo record, which carries clientId,

# clientSecret, email and password

# (see AppAuth in @commercelayer/cli-core src/application.ts)

# <key>.token.json — the OAuth access token

# https://github.com/commercelayer/commercelayer-cli/blob/main/src/config.ts

# `config.configDir` is oclif's. @oclif/core (pinned at ^3.27.0) computes it in

# Config.load as `dir('config')`:

# base = XDG_CONFIG_HOME || (windows && LOCALAPPDATA) || ~/.config

# configDir = join(base, this.dirname)

# and `this.dirname = this.pjson.oclif.dirname || this.name`. commercelayer's

# oclif block sets no `dirname`, so it falls back to the package name,

# `@commercelayer/cli` — the scope is a real directory level. On Windows oclif

# turns the first slash into a backslash, giving

# %LOCALAPPDATA%\@commercelayer\cli.

# https://github.com/oclif/core/blob/main/src/config/config.ts

secret = [

"~/.config/@commercelayer/cli/applications/",

"%LOCALAPPDATA%/@commercelayer/cli/applications/",

]

[commands]

format = 1

label = "Commerce Layer CLI"

description = "List the logged-in CLI applications. Login (applications:add) takes a client secret and is left out, as are the plugin commands."

quality = "ai-draft"

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

[[commands.subcommand]]

path = ["applications"]

label = "List applications"

description = "Show the logged-in applications, optionally filtered."

[[commands.subcommand.source]]

id = "docs"

kind = "help"

url = "https://raw.githubusercontent.com/commercelayer/commercelayer-cli/HEAD/packages/cli/docs/applications.md"

revision = "2026-10-27"

evidence = """

<value>] [-A core|provisioning | -o <value>] [-S]

-A, --api=<option> specific API application

<options: core|provisioning>

-S, --sort sort applications by Organization and Application name

-a, --alias=<value> the alias associated to the application

-k, --kind=<option> application kind

<options: integration|sales_channel|user>

-m, --mode=<option> execution mode

<options: test|live>

-o, --organization=<value> organization slug

"""

[[commands.subcommand.field]]

id = "kind"

label = "Application kind"

type = "enum"

option = ["--kind", "-k"]

choices = [

{ value = "integration", label = "integration" },

{ value = "sales_channel", label = "sales channel" },

{ value = "user", label = "user" },

]

sources = ["docs"]

[[commands.subcommand.field]]

id = "mode"

label = "Mode"

type = "enum"

option = ["--mode", "-m"]

choices = [

{ value = "test", label = "test" },

{ value = "live", label = "live" },

]

sources = ["docs"]

[[commands.subcommand.field]]

id = "api"

label = "API"

type = "enum"

option = ["--api", "-A"]

choices = [

{ value = "core", label = "core" },

{ value = "provisioning", label = "provisioning" },

]

sources = ["docs"]

[[commands.subcommand.field]]

id = "organization"

label = "Organization slug"

type = "string"

option = ["--organization", "-o"]

sources = ["docs"]

[[commands.subcommand.field]]

id = "alias"

label = "Application alias"

type = "string"

option = ["--alias", "-a"]

sources = ["docs"]

[[commands.subcommand.field]]

id = "sort"

label = "Sort by organization and name"

type = "boolean"

option = ["--sort", "-S"]

sources = ["docs"]

[[commands.subcommand.task]]

id = "list"

label = "List applications"

fields = ["kind", "mode", "api", "organization", "alias", "sort"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["kind", "mode", "organization", "alias", "sort"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["api"]

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/commercelayer. 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.