Lepsto CLI
Look up installation, authentication, flags, and CLI exit codes.
The lepsto CLI runs platform operations from a terminal or CI. Its command tree comes from the operation catalog available to the current identity and product.
Installation and authentication
Task | Command | Behavior |
|---|---|---|
Install | npm i -g @lepsto/cli | Installs the lepsto command and the deprecated lessly alias. |
Sign in interactively | lepsto auth login | Prints a user code and verification URL; approve the request in a browser. |
Authenticate automation | lepsto auth login --token "$LESSLY_TOKEN" | Uses the supplied product-scoped token without a browser. Set LESSLY_TOKEN to your token first. |
List products | lepsto organization product list | Lists the products the authenticated identity can access. |
Select a product | lepsto product select <product-id> | Stores the product in the local CLI config when the credential does not already pin one. CLI 0.5.0+ passes it as the product argument on each product-scoped call. |
The lessly alias runs the same CLI and prints a deprecation message to stderr. It leaves stdout unchanged, but is scheduled for removal. Use lepsto in new scripts. LESSLY_TOKEN above is the environment variable used in the supported token example; preserve its spelling.
Command shape
lepsto <namespace> <resource> <action> [flags]Flags for an operation come from that operation’s input schema. New platform operations become available through catalog discovery without a CLI upgrade.
Convention | Accepted form |
|---|---|
Default output | Human-readable table. |
Machine-readable output | --json, or -o json, -o yaml, -o table. |
Connection flags | --profile and --refresh go before the command. |
Behavior flags | -o, --json, --input, and --yes go after the command. |
Mutation confirmation | --yes or --force skips the prompt. Without it, an unattended mutation fails immediately. |
Exit codes
Code | Meaning |
|---|---|
0 | Success. |
1 | Generic failure. |
2 | Validation error. |
3 | Authentication or token problem. |
4 | Not found or forbidden. |
After signing in, lepsto organization product list should return your accessible products, or an empty result if you have none. An authentication failure is not an empty product list.