zuno providers

zuno providers manages which model providers this installation can reach and the credentials it holds for them. Login methods differ per provider, so the flow is: ask which methods a provider implements, authenticate with one of them, and remove the stored credential when it is no longer wanted.

Credentials are stored locally. logout removes them, which is what to run before handing over a machine or rotating an account.

Synopsis

zuno providers [OPTIONS] <COMMAND>

Options

Option	Description	Default
-v, --version	Show the Zuno package version
--print-logs	Print logs to stderr in addition to the structured local log store
--log-level <LOG_LEVEL>	Set the minimum log level. Possible values: TRACE, DEBUG, INFO, WARN, ERROR
--sandbox <SANDBOX>	Select Shell confinement for this invocation. Possible values: read-only, workspace-write, danger-full-access
--sandbox-on-unavailable <ACTION>	Select what happens when confined Shell cannot be deployed. Possible values: deny, run-unconfined	deny
-h, --help	Print help (see a summary with -h)

Subcommands

Subcommand	Description
list
methods	List the login methods implemented for a provider
login	Authenticate a provider with one of its implemented login methods
logout
help	Print this message or the help of the given subcommand(s)

zuno providers list

zuno providers list [OPTIONS]

Option	Description	Default
-v, --version	Show the Zuno package version
--print-logs	Print logs to stderr in addition to the structured local log store
--log-level <LOG_LEVEL>	Set the minimum log level. Possible values: TRACE, DEBUG, INFO, WARN, ERROR
--sandbox <SANDBOX>	Select Shell confinement for this invocation. Possible values: read-only, workspace-write, danger-full-access
--sandbox-on-unavailable <ACTION>	Select what happens when confined Shell cannot be deployed. Possible values: deny, run-unconfined	deny
-h, --help	Print help (see a summary with -h)

zuno providers methods

List the login methods implemented for a provider.

zuno providers methods [OPTIONS] <PROVIDER>

Argument	Description
<PROVIDER>	Provider id or display name

Option	Description	Default
-v, --version	Show the Zuno package version
--print-logs	Print logs to stderr in addition to the structured local log store
--log-level <LOG_LEVEL>	Set the minimum log level. Possible values: TRACE, DEBUG, INFO, WARN, ERROR
--sandbox <SANDBOX>	Select Shell confinement for this invocation. Possible values: read-only, workspace-write, danger-full-access
--sandbox-on-unavailable <ACTION>	Select what happens when confined Shell cannot be deployed. Possible values: deny, run-unconfined	deny
-h, --help	Print help (see a summary with -h)

zuno providers login

Authenticate a provider with one of its implemented login methods.

zuno providers login [OPTIONS] [TARGET]

Argument	Description
[TARGET]	Provider id/name, or an HTTPS URL implementing /.well-known/zuno. Omit in a terminal to choose interactively

Option	Description	Default
-p, --provider <PROVIDER>	Provider id or display name, as an alternative to the positional target
-v, --version	Show the Zuno package version
-m, --method <METHOD>	Method id shown by zuno auth methods <provider>. Omit in a terminal to choose when several methods are available
--print-logs	Print logs to stderr in addition to the structured local log store
--log-level <LOG_LEVEL>	Set the minimum log level. Possible values: TRACE, DEBUG, INFO, WARN, ERROR
--sandbox <SANDBOX>	Select Shell confinement for this invocation. Possible values: read-only, workspace-write, danger-full-access
--sandbox-on-unavailable <ACTION>	Select what happens when confined Shell cannot be deployed. Possible values: deny, run-unconfined	deny
-h, --help	Print help (see a summary with -h)

zuno providers logout

zuno providers logout [OPTIONS] [PROVIDER]

Argument	Description
[PROVIDER]

Option	Description	Default
-v, --version	Show the Zuno package version
--print-logs	Print logs to stderr in addition to the structured local log store
--log-level <LOG_LEVEL>	Set the minimum log level. Possible values: TRACE, DEBUG, INFO, WARN, ERROR
--sandbox <SANDBOX>	Select Shell confinement for this invocation. Possible values: read-only, workspace-write, danger-full-access
--sandbox-on-unavailable <ACTION>	Select what happens when confined Shell cannot be deployed. Possible values: deny, run-unconfined	deny
-h, --help	Print help (see a summary with -h)

Examples

See which providers this installation knows about.

zuno providers list

Ask a provider which login methods it implements before choosing one.

zuno providers methods openai

Authenticate with an explicit method instead of the interactive picker.

zuno providers login openai --method api-key

Remove the stored credential for one provider.

zuno providers logout openai

See also

• Global options
• zuno models
• zuno mcp
• Excluded commands
• Providers reference
• Configuration reference