Add a CLI Command

End-to-end workflow for adding a new command to cx. Every command falls into one of two archetypes - determine which one first, then follow the corresponding steps.

docs/adding-a-command.md has copy-pasteable code templates for every step below. Read it alongside this workflow.

Step 0: Understand What You're Building

Before writing any code, get clarity on the domain:

1. What Coralogix API are you wrapping? Find the API docs or example responses. Understand the data model - what entities exist, what fields they have, what operations are supported.
2. What should the user be able to do? List the subcommands (e.g., list, get, create) and what flags make sense.
3. Does this belong under a wrapper group? The CLI organizes related commands into wrapper groups. Check if your command fits under an existing group before creating a top-level command:
   • cx alerts - alert definitions + schedulers
   • cx notifications - connectors, routers, presets, test
   • cx webhooks - outgoing webhooks + actions
   • cx enrichments - enrichment rules + custom enrichment tables
   • cx integrations - integrations + extensions, contextual-data
   • cx iam - api-keys, roles, scopes, users, groups, saml, ip-access