Documentation Index
Fetch the complete documentation index at: https://docs.guild.ai/llms.txt
Use this file to discover all available pages before exploring further.
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
| State | Description |
|---|
| Saved | Code is uploaded and stored |
| Validated | Runtime has verified the agent builds and conforms to its schemas |
| Published | Available to your organization for installation |
Testing before publishing
Use guild agent test to create a temporary version for testing without saving:
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
