ContextQMD
Back to Nocobase

nb session

docs/docs/en/api/cli/session/index.md

2.1.171.1 KB
Original Source

nb session

Manage session mode for NB_SESSION_ID.

After session mode is enabled, nb env use and nb env current use the current shell or agent runtime context first, instead of directly sharing a single global current env.

Usage

bash
nb session <command>

Subcommands

CommandDescription
nb session setupInstall shell or runtime integration for NB_SESSION_ID
nb session idShow the current effective session id
nb session removeRemove shell or runtime integration for NB_SESSION_ID

When you need it

The default recommendation is to run nb session setup once when you first start using the CLI. With it enabled:

  • terminal 1 can use env1
  • terminal 2 can use env2 at the same time
  • an agent runtime can keep its own current env too

Without session mode, different sessions fall back to sharing the global last env, which makes parallel work more likely to affect each other.