Context - GroundForge

Most GroundForge commands require an Organization, Workspace, and environment. The CLI stores these values in the active context, so you don’t have to repeat them on every command.

Show the context

gforge context
gforge context -o yaml

Change the context

gforge context set \
  --organization <organization-id> \
  --workspace <workspace-id> \
  --environment <environment>

Override one command

Use command-level flags when a script needs to operate against a different scope without changing your saved profile:

gforge agents list \
  --organization-id <organization-id> \
  --workspace-id <workspace-id> \
  --environment <environment>

Always verify context before create, update, delete, approval, or credential operations — it’s the single easiest mistake to avoid. Next: Resources.

Last modified on July 27, 2026

Related topics

Login Operator Review Workspaces CLI Overview