Skip to main content
Every time you save an agent, Guild creates a new version. Versions let you iterate on agent code while keeping previous versions available.

​
Version lifecycle

# Save a new version
guild agent save --message "Add error handling"

# Save and wait for validation
guild agent save --message "Add error handling" --wait

# Save, validate, and publish in one step
guild agent save --message "Add error handling" --wait --publish

​
Version states

StateDescription
SavedCode is uploaded and stored
ValidatedRuntime has verified the agent builds and conforms to its schemas
PublishedAvailable to your organization for installation

​
Testing before publishing

Use guild agent test to create a temporary version for testing without saving: 
guild agent test
Ephemeral versions are created automatically when testing from a local agent directory and don’t appear in your version history.

​
Listing versions

# List all versions of an agent
guild agent versions

​
Publishing

Publishing makes a validated version available to your organization. Other team members can install published agents into their workspaces. 
# Publish the latest validated version
guild agent publish