The clay CLI

The clay CLI is Clay's primary programmatic surface, optimized for agents: JSON output and typed error codes. It authenticates via clay login (browser OAuth; run the setup skill once if clay whoami fails). The workspace is resolved from the stored session — there is no workspace id to pass.

Discovering what you can do

clay --help is the authoritative, up-to-date list of command groups — the help text is a machine-readable spec written for you to read. Don't assume the surface is only workflows: when a user asks "what can I do?", run clay --help and surface everything.

clay --help                 # all command groups (workflows, tables, routines, webhooks, …)
clay <group> --help         # a group's subcommands
clay <group> <cmd> --help   # exact flags, JSON output shape, and error codes