For AI agents: a documentation index is available at /llms.txt. Markdown versions of all documentation pages are available by appending .md to the URL path.
End-to-end shell pipelines that chain visa-cli commands into deployable
artifacts. Every recipe uses the canonical --json envelope contract
documented in the CLI piping guide.
These pages are versioned alongside the CLI — a contract test (see
packages/cli/tests/unit/recipe-surface.test.ts) checks that every
subcommand and flag referenced in these recipes exists in the CLI surface on
every PR, so the docs can't drift from the binary.
| Recipe | Outcome | Approx cost |
|---|---|---|
| A — Landing site builder | Deployable single-page site with logo, hero, copy, ambient music | ~$0.17 |
| B — Album drop | 90s instrumental track + cover art + music video bundle | ~$0.21 |
| C — Podcast episode | Article URL → script → narrated audio + cover art | ~$0.11 |
| D — Vision-critic refinement loop | N rounds of image generation + LLM critique | ~$0.05 × N |
| E — PR description auto-writer | git diff → polished PR body |
~$0.04 |
| F — Voice-cloned audiobook chapter | Reference audio + chapter text → narrated MP3 | ~$0.03 / chapter |
| G — Image → 3D asset | Prompt → reference image → printable mesh | ~$0.12 |
| H — Multi-modal news roundup | Topic → 5 headlines + per-story illustration | ~$0.21 |
visa-cli >= 2.1.0 (introduces the --json envelope contract)visa-cli cards add)visa-cli balance topup --amount 5)jq for JSON field extraction (or use --from-stdin <field> instead)Every recipe is a self-contained bash script. To run:
chmod +x recipe.sh
./recipe.sh
The --yes flag on every paid command in the recipes is what lets them run
in non-TTY shells (cron, CI, scripts). Strip it if you want each charge to
require an interactive confirmation.