nb env use

Switch the current CLI env. Commands that omit --env will use this env by default afterward.

When session mode is enabled for the current shell or runtime, this change only affects the current session.

When session mode is not enabled, this falls back to updating the global last env. In that case, other terminals or agent runtimes without session isolation may also be affected.

Usage

nb env use <name>

Parameters

ParameterTypeDescription
<name>stringConfigured environment name to switch to

Examples

nb env use local

Recommendation

The default recommendation is to run nb session setup once first. That makes nb env use behave more like use dbname in a database client: switch the current session context first, then run follow-up commands that depend on that env.