Skip to content
offprompt

Asking for values

Each key in a collect_secret request says how its value comes to be, in one of four ways. The agent picks one per key, and the tool's description teaches it which fits.

Asked asForWhat you see
generate: {}AUTH_SECRET, JWT_SECRET, encryption keysNothing to type: the page makes a random value as it opens, with Regenerate
provider: "stripe"STRIPE_SECRET_KEYThe provider's logo, a link to where the key is made, and its checks
format: "postgres_url"DATABASE_URLWhat the value is, its checks, and links to create one with Supabase, Neon or PlanetScale
none of theseMAX_RETRIES, anything elseA plain field
{
  "secrets": [
    { "name": "STRIPE_SECRET_KEY", "provider": "stripe" },
    { "name": "DATABASE_URL", "format": "postgres_url" },
    { "name": "AUTH_SECRET", "generate": {} },
    { "name": "MAX_RETRIES", "format": "integer", "secret": false }
  ],
  "reason": "Checkout signs its requests with Stripe, and the app needs a database and a session secret.",
  "sink": { "kind": "dotenv", "path": ".env" }
}

A key takes at most one of generate, provider and format.

A provider's key

provider names a provider in offprompt's registry. The field shows its logo, links to the page where the key is made, and checks the value against the key's rules, which are mostly a prefix and a length. That catches the most common slip, pasting a key from the wrong provider.

When a provider issues several keys, the variable's name says which: STRIPE_WEBHOOK_SECRET with provider: "stripe" is Stripe's webhook signing secret. When the name does not say, the agent names the key as provider/key, such as stripe/webhook_secret, and offprompt refuses a request that leaves it unclear.

A key named the usual way is recognised even when the agent names no provider. OPENAI_API_KEY on its own gets OpenAI's logo, link and checks. Names are matched with framework prefixes dropped, so NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY is Supabase's publishable key too; the prefixes are NEXT_PUBLIC_, NUXT_PUBLIC_, EXPO_PUBLIC_, REACT_APP_, GATSBY_, VITE_ and PUBLIC_.

A known kind of value

format is for a value no one provider issues, such as a Postgres connection string, a UUID or a PEM block. The field says what the value is and checks it. Where a provider can create one, the field links there for someone who has none yet. Formats lists them all.

Formats that take several lines, base64, jwt, pem and json, get a taller field, shown in the clear, with a file picker.

Anything else

A key with none of the three, whose name no provider's key goes by, is plain text with no checks.

Values that are not secret

secret: false shows a value in the clear, for one that is not secret, such as MAX_RETRIES or a sender address. The registry says the same of a provider's public keys, such as Stripe's publishable key.

Captions

caption is one short line under the field's name, up to 90 characters, such as where to find the value: "Stripe dashboard → Developers → API keys".

Where a value is made

link takes you to the page where a value is made. It comes in two forms.

Parameters, for a provider's key

Some keys are made on a page that belongs to one account, organisation or project, whose ID or name is in the page's address. For those, the agent names it, and the field's Get it opens that page rather than one that asks you which:

[
  { "name": "SUPABASE_SECRET_KEY", "provider": "supabase", "link": { "project": "abcdefghijklmnopqrst" } },
  { "name": "R2_ACCESS_KEY_ID", "provider": "cloudflare", "link": { "account": "023e105f4ecef8ad9ca31a8372d0c353" } },
  { "name": "SENTRY_AUTH_TOKEN", "provider": "sentry", "link": { "org": "acme-inc" } }
]
KeysParameterWhat it isWhere a project keeps it
Supabase's secret and publishable keysprojectThe project ref, 20 lowercase lettersThe subdomain of SUPABASE_URL, or supabase/.temp/project-ref once supabase link has run. The project_id at the top of supabase/config.toml is a local name, not the ref
Cloudflare's R2 access key ID and secret access keyaccountThe account ID, 32 hexadecimal digitsaccount_id in wrangler.toml or wrangler.jsonc, or CLOUDFLARE_ACCOUNT_ID
Sentry's auth tokenorgThe organization slugorg in .sentryclirc, defaults.org in sentry.properties, or SENTRY_ORG

The tool's schema gives the agent the same list, and tells it to read the values from the project rather than guess. Each address comes from the provider's own docs or source.

A value fills one whole part of the address, a path segment or the first part of the host, and takes only letters, digits, ., _ and -, so it can choose which of the provider's pages opens and nothing else: never another path, a query or another site. A parameter that is missing or does not fit leaves Get it on the key's usual page, and the result says why.

An address, for anything else

For a key no provider issues, such as an internal tool's token, link is the https address where it is made:

{ "name": "VAULT_TOKEN", "link": "https://vault.acme.internal/ui/vault/access/tokens/new" }

The field shows it as the agent's suggestion, "Suggested by Claude Code", with its whole host, set apart from offprompt's own links. Clicking it opens a box, "Open vault.acme.internal?", which says the link was proposed by your agent and not verified by offprompt, and shows the whole address. Only Open in that box opens it, in a new tab that is not told which page sent you. A provider's key can take an address too; it shows under the key's Get it, never in its place.

An address that is not https, or that names a user before its host, as https://github.com@lookalike.example does, is dropped.

What the agent hears

The result's links says what became of each: used as the key's Get it, shown as a suggestion, or dropped, with why. A link that cannot be used never stops the request.

Generated values

generate asks for a random value, for signing and encryption secrets such as AUTH_SECRET, JWT_SECRET and SESSION_SECRET:

[
  { "name": "AUTH_SECRET", "generate": {} },
  { "name": "ENCRYPTION_KEY", "generate": { "bytes": 32, "encoding": "hex" } }
]

bytes is 16 to 64, 32 unless set. encoding is base64url, base64 or hex, base64url unless set.

  • The page makes the value from your browser's random bytes as it opens. It is masked like any other; you can show it, make another with Regenerate, or paste one you already use, which is checked to be as long as one offprompt would make and in the same encoding.
  • A field that comes back empty, as it does with the page's script off, is made by offprompt at write time.
  • A key the file already holds is kept as it is, since a new signing or encryption secret signs everyone out or leaves stored data unreadable. The result lists it under kept.
  • A request of generated keys alone opens no page at all: offprompt makes them, writes them and answers at once. It refuses a git-tracked file there, since only you can allow that write, on the page.

The agent never sees a generated value either.

One request for everything

A request takes one to twelve keys, and they share one page, one wait and one atomic write. Agents are told to ask for every key a task needs in one call, so you paste once.

The reason

reason is shown on the page as the agent's claim about why it needs the values, so it is written for you: up to 2,000 characters of Markdown, rendered with bold, italics, code, lists and quotes. Links show their address as text and are not clickable; a key's link is the way to give one you can open.