| name | coupongo |
| description | Use this skill when Codex needs to operate CouponGo, the AI-friendly CLI for managing Stripe coupons and promotion codes. Trigger for tasks involving `coupongo`, Stripe coupon or promotion-code listing, creation, update, deletion, batch generation, configuration inspection, `coupongo schema`, `coupongo doctor`, or agent-safe non-interactive CouponGo workflows. |
CouponGo
Workflow
- Resolve the CLI:
- In this repository, run
make build and use ./build/coupongo.
- Outside the repository, use
coupongo from PATH.
- Inspect readiness with
coupongo doctor --ai.
- Inspect the current command contract with
coupongo schema.
- For agent-run operations, prefer
--ai --env <environment> and parse the JSON envelope.
- For list commands, pass
--limit <1..100> and use --starting-after <id> for pagination.
Rules
- Use non-interactive flags. Do not rely on prompts.
- Do not invent Stripe IDs. List or get resources first, then act on exact IDs.
- Treat
--ai as the stable automation contract: JSON on stdout for success, JSON on stderr for errors, no ANSI color, no prompts.
- Check
error.kind before retrying. Fix usage locally; ask for config or credentials on auth; list resources again on not_found; retry only network.
- Do not run production writes unless the user explicitly requests production/live or confirms the target environment.
- For destructive coupon deletion, use
--yes only after user intent is explicit.
- Never expose real Stripe API keys. Use masked values from
doctor or config show --ai.
Common Commands
coupongo doctor --ai
coupongo schema
coupongo config path --ai
coupongo config list-env --ai
coupongo coupon list --ai --env test --limit 20
coupongo coupon get <coupon_id> --ai --env test
coupongo coupon create --ai --env test --percent-off 20 --duration once --name "Launch 20"
coupongo coupon create --ai --env test --amount-off 1500 --currency usd --duration repeating --duration-in-months 3
coupongo coupon update <coupon_id> --ai --env test --name "Updated name"
coupongo coupon delete <coupon_id> --ai --env test --yes
coupongo promo list --ai --env test --coupon <coupon_id> --limit 50
coupongo promo get <promo_id> --ai --env test
coupongo promo create <coupon_id> --ai --env test --code SAVE20 --max-redemptions 100
coupongo promo create <coupon_id> --ai --env test --prefix SAVE --separator -
coupongo promo batch <coupon_id> --ai --env test --count 50 --prefix SAVE --max-redemptions 1
coupongo promo update <promo_id> --ai --env test --active=false
Configuration
Use config writes only when the user provides the key or asks to configure CouponGo:
coupongo config init --ai --env-name test --api-key <sk_...> --currency usd --output-format table --skip-test
coupongo config add-env staging --ai --api-key <sk_...> --currency usd --output-format table
coupongo config set-key staging --ai --api-key <sk_...>
coupongo config use staging --ai
coupongo config remove-env staging --ai --yes
