Start an interactive chat session with a Kapso agent.

kapso run [AGENTID]

​
Arguments

ArgumentDescriptionDefault
AGENTIDAgent identifierFrom agent.yaml

​
Description

Initiates an interactive terminal session with the specified agent. Useful for local testing and debugging agent behavior.

Process flow:

  1. Creates a snapshot with the locally defined agent
  2. Establishes connection to deployed agent
  3. Creates interactive terminal interface
  4. Handles bidirectional message exchange

The created snapshot can also be tested on the web interface.

​
Examples

With local configuration:

kapso run

With explicit agent ID:

kapso run agent_123456789

​
Notes

  • Requires valid authentication token
  • Session history is ephemeral
  • Exit with Ctrl+C
  • Changes made locally will be reflected in the test session
  • The snapshot is accessible through the web interface for team collaboration