docs(cli-generator): document named profiles for multi-tenant CLIs

[devin-ai-integration]

Summary

The CLI generator can now emit named profiles in generated CLIs: a profiles command group plus a global --profile / -p flag that stores a tenant's credential, parameter defaults, server URL variables, base URL, retry limit, and default output format under a name. This matters for users of multi-tenant APIs (account SIDs, org slugs, workspaces): they set the tenant context once instead of passing it on every command, secrets stay in the OS keychain rather than a config file, and CI environment variables still take precedence over a developer's stored profile. The feature is opt-in (profiles.enabled: true) and a CLI generated without it is unchanged.

Implements docs for: feat(cli-generator): add named profiles for multi-tenant CLIs (fern-api/fern#17654)

Sources: generators/cli/src/customConfig.ts (config schema: enabled, commandName, revokeOperation), generators/cli/sdk/docs/customize.md, and ADR-0011 on fern-api/fern main.

Pages changed

• fern/products/cli-generator/configuration.mdx: new profiles ParamField with profiles.enabled, profiles.commandName, profiles.revokeOperation (all three verified in the generator's config schema) and a generators.yml example.
• fern/products/cli-generator/authentication.mdx: new canonical ## Named profiles section (managing/selecting profiles, <PREFIX>_PROFILE, precedence incl. the explicit -p vs ambient-profile distinction from ADR-0011, keychain storage, single-level --parent inheritance).
• fern/products/cli-generator/features.mdx: cross-refs from retries (--retries <N> resolution order), server URL variables (<PREFIX>_<VARIABLE> env var naming), and --schema (builtinCommands).
• fern/products/cli-generator/state-of-the-world.mdx: added profiles to current capabilities and removed "Multiple credential profiles" from the roadmap's "Next" column.

Validation: fern check --warnings (0 errors; remaining warnings are preexisting) and pre-commit/vale on the changed files (0 errors/warnings).

Link to Devin session: https://app.devin.ai/sessions/2825c85857d24cc991e2ccbc86bde189
Open in Devin Desktop: https://app.devin.ai/desktop/session/2825c85857d24cc991e2ccbc86bde189?variant=devin

[devin-ai-integration]

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

• Disable automatic comment, CI, and merge conflict monitoring

[github-actions]

📝 [vale] <FernStyles.Acronyms> _{reported by reviewdog 🐶}
'SID' has no definition.

[github-actions]

📝 [vale] <FernStyles.Adverbs> _{reported by reviewdog 🐶}
Remove 'silently' if it's not important to the meaning of the statement.

Suggested change

A profile is selected by, in order, `--profile` / `-p`, the `<PREFIX>_PROFILE` environment variable, then the profile marked active by `profiles use`, where `<PREFIX>` is the binary name uppercased with `-` replaced by `_`. With no profile selected, the CLI behaves as if the feature were absent. A named profile that doesn't exist is an error rather than a fallthrough to environment credentials, so a command never silently runs against the wrong tenant. The `profiles` group itself always runs unprofiled, so a stale active pointer can be repaired.

A profile is selected by, in order, `--profile` / `-p`, the `<PREFIX>_PROFILE` environment variable, then the profile marked active by `profiles use`, where `<PREFIX>` is the binary name uppercased with `-` replaced by `_`. With no profile selected, the CLI behaves as if the feature were absent. A named profile that doesn't exist is an error rather than a fallthrough to environment credentials, so a command never runs against the wrong tenant. The `profiles` group itself always runs unprofiled, so a stale active pointer can be repaired.

[github-actions]

🌿 Preview your docs: https://fern-preview-devin-1789837675-cli-generator-profiles.docs.buildwithfern.com/learn

Here are the markdown pages you've updated:

• learn/cli-generator/get-started/authentication
• learn/cli-generator/get-started/configuration
• learn/cli-generator/get-started/features
• learn/cli-generator/get-started/state-of-the-world