Skip to main content

Documentation Index

Fetch the complete documentation index at: https://snowglobe.so/docs/llms.txt

Use this file to discover all available pages before exploring further.

This command starts a Snowglobe session with your chatbot connected to it.

Prerequisites

  • Installed and authenticated snowglobe-connect
  • Wrapper created and tested
  • .snowglobe/agents.json and .snowglobe/config.rc exist (created by init)

What this does

  • Binds your wrapper so it can call Snowglobe during a session
  • Processes scenarios created in Snowglobe and sends them to your chatbot
  • Sends the chatbot’s response back to Snowglobe
  • Streams basic status to your terminal while active

Usage

snowglobe-connect start

Running with multiple agents

If your project has more than one agent registered, snowglobe-connect start will display a numbered list of your agents and ask you to choose which ones to include in the session. You can select individual agents, ranges, or enter * to run all of them. Only the agents you select will be active during the session. To skip the prompt (e.g. in CI or automated workflows), pass agent IDs directly:
snowglobe-connect start --agent-ids <id1>,<id2>
snowglobe-connect start --agent-ids '*'
Agent IDs can be found in the selection table or in your .snowglobe/agents.json file.
Running fewer agents at a time means faster polling and quicker test results — only select the agents you need for your current session.

During the run

  • Keep this terminal session open while testing or running simulations
  • Use Ctrl+C to stop

Next: Run a simulation

Return to the Snowglobe dashboard to kick off a simulation with your connected chatbot.