Retrieves and replaces the local agent definition and tests with those defined on the server. 
kapso pull [AGENTID] [OPTIONS]

​
Arguments

ArgumentDescriptionDefault
AGENTIDAgent identifierInteractive selection

​
Options

OptionDescriptionDefault
--project-id, -pProject ID (required when using KAPSO_API_KEY)None
--yes, -ySkip confirmation promptsFalse

​
Description

This command synchronizes your local files with the version stored on the Kapso server. It pulls and replaces:
  1. Agent graph definition (agent.yaml)
  2. Test suites and test cases
This is useful when:
  • The agent has been modified through the web interface
  • Multiple team members are working on the same agent
  • You need to reset local changes to the server version

​
Examples

Interactive agent selection: 
kapso pull
Pull specific agent: 
kapso pull agent_123456789
Pull with project ID (useful with KAPSO_API_KEY): 
kapso pull agent_123456789 --project-id proj_123456
Skip confirmation prompts: 
kapso pull agent_123456789 --project-id proj_123456 --yes

​
Notes

  • Requires valid authentication token or KAPSO_API_KEY environment variable
  • When using KAPSO_API_KEY, provide both agent ID and project ID to avoid login
  • Will prompt for confirmation before overwriting existing files (unless —yes is used)
  • Creates necessary directories if they don’t exist