Asc CLI Usage

asc CLI Usage

Iron Law

NEVER GENERATE ASC COMMANDS WITHOUT RUNNING asc --help OR SUBCOMMAND --help FIRST

Always use --help to discover current flags and subcommands. The asc CLI evolves — never assume flags from memory.

Command discovery

• Always use --help to discover commands and flags.
  • asc --help
  • asc builds --help
  • asc builds list --help

Flag conventions

• Use explicit long flags (e.g., --app, --output).
• No interactive prompts; destructive operations require --confirm.
• Use --paginate when the user wants all pages.

Output formats

• Default output is minified JSON.
• Use --output table or --output markdown only for human-readable output.
• --pretty is only valid with JSON output.

Authentication and defaults

• Prefer keychain auth via asc auth login.
• Fallback env vars: ASC_KEY_ID, ASC_ISSUER_ID, ASC_PRIVATE_KEY_PATH, ASC_PRIVATE_KEY, ASC_PRIVATE_KEY_B64.
• ASC_APP_ID can provide a default app ID.

Timeouts

• ASC_TIMEOUT / ASC_TIMEOUT_SECONDS control request timeouts.
• ASC_UPLOAD_TIMEOUT / ASC_UPLOAD_TIMEOUT_SECONDS control upload timeouts.

Documentation Sources