Wait

tealc wait [AGENT_NAME] blocks until an agent connects to the server and comes online. This is useful in scripts and automation that need to wait for an agent before proceeding.

Quick usage

# Wait indefinitely for the agent to come online
tealc wait [AGENT_NAME] --wait-timeout=0

# Wait for at most 30 seconds
tealc wait [AGENT_NAME] --wait-timeout=30

Timeout behavior

The --wait-timeout flag controls how long to wait:

• Zero or negative (default -1): Wait indefinitely until the agent is online.
• Positive (e.g., 30): Wait for at most N seconds, polling every second until the agent comes online or the timeout expires.

Options

Wait uses the common client connection options documented in the configuration reference. The command-specific option is:

• --wait-timeout: zero or negative waits indefinitely; a positive value limits the wait to that many seconds.