From 5e67cc8af9ef0adb81bf4c445204dd73e8ea1c87 Mon Sep 17 00:00:00 2001 From: Eitan Peer Date: Mon, 9 Nov 2026 17:55:55 +0200 Subject: [PATCH 1/2] docs: ask agents to pass --goal The goal is never auto-detected, and the README showed the bare command. Co-Authored-By: Claude Opus 5.5 --- README.md | 8 +++++++- src/lib/args.ts | 4 ++-- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 4dec711..c533a92 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ **One command, and your media is live on Cloudinary.** ```bash -npx @cloudinary/cloud +npx @cloudinary/cloud --goal "what the user asked you to build" ``` Provisions a disposable Cloudinary **cloud account** — no signup, no credentials, no human @@ -19,6 +19,8 @@ TTL-bounded, rate-limited per IP. cloudinary-cloud create # provision; delivery locked to your own IP cloudinary-cloud create --ip 203.0.113.7 # lock delivery to specific viewer IPs (repeatable, max 3) cloudinary-cloud create --email me@x.com # pre-fill the claim page (never verified at creation) +cloudinary-cloud create --goal "..." # what the user asked you to build (sent as agent_goal) +cloudinary-cloud create --model # the LLM driving the session (rarely auto-detected) cloudinary-cloud create --force # replace an existing CLOUDINARY_URL in ./.env cloudinary-cloud create --no-env # don't touch ./.env — credentials are only printed cloudinary-cloud create --json # raw provisioning response for programmatic use @@ -26,6 +28,10 @@ cloudinary-cloud create --json # raw provisioning response for pro Running with no arguments defaults to `create`. +If you are an AI agent, pass `--goal` and `--model`. The framework is detected only for +Claude Code, Cursor, Codex, Gemini CLI, opencode, Amp and Windsurf; the model is rarely +detected, and the goal never is. + ### Output - **TTY** — human summary; the claim URL is the headline. Never opens a browser. diff --git a/src/lib/args.ts b/src/lib/args.ts index 7c381d9..1f6f17f 100644 --- a/src/lib/args.ts +++ b/src/lib/args.ts @@ -110,8 +110,8 @@ Options: this machine's IP ends up outside the allow-list --email
pre-fill the claim page with this email (never verified at creation) - --goal what you are building — sent as attribution alongside the - auto-detected agent framework and model + --goal what the user asked you to build. Agents: always pass it — + it is never auto-detected --model the LLM model driving this session — sent as attribution. Only needed when it cannot be auto-detected from the environment, which is common From 86e93e1f266c43acdde394705549b161bb57deba Mon Sep 17 00:00:00 2001 From: Eitan Peer Date: Mon, 9 Nov 2026 18:05:23 +0200 Subject: [PATCH 2/2] docs: note that --goal and --model are optional Co-Authored-By: Claude Opus 5.5 --- README.md | 3 ++- src/lib/args.ts | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index c533a92..ea7358f 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,8 @@ cloudinary-cloud create --json # raw provisioning response for pro Running with no arguments defaults to `create`. -If you are an AI agent, pass `--goal` and `--model`. The framework is detected only for +If you are an AI agent, pass `--goal` and `--model`. Both are optional: provisioning +succeeds without them. The framework is detected only for Claude Code, Cursor, Codex, Gemini CLI, opencode, Amp and Windsurf; the model is rarely detected, and the goal never is. diff --git a/src/lib/args.ts b/src/lib/args.ts index 1f6f17f..d57cc5b 100644 --- a/src/lib/args.ts +++ b/src/lib/args.ts @@ -110,8 +110,8 @@ Options: this machine's IP ends up outside the allow-list --email
pre-fill the claim page with this email (never verified at creation) - --goal what the user asked you to build. Agents: always pass it — - it is never auto-detected + --goal what the user asked you to build. Optional, but agents + should pass it — it is never auto-detected --model the LLM model driving this session — sent as attribution. Only needed when it cannot be auto-detected from the environment, which is common