Skip to main content
Publishing makes an agent version available for installation. Today, the CLI docs describe publishing as making an agent available to your organization.

​
Publish with `guild agent save`

You can save, validate, and publish in one command: 
guild agent save --message "Ready to ship" --wait --publish

​
Key flags

  • `—message`: Sets the version message for this save.
  • `—wait`: Blocks until validation passes.
  • `—publish`: Publishes after a successful save (and after validation if you also pass `—wait`).

​
Publish separately

If you already saved a draft version, you can publish later: 
guild agent publish
To wait for validation before publishing: 
guild agent publish --wait

​
Visibility and who can install

Agents have three visibility states:
  • Draft: no published version. The agent is not available for installation.
  • Team-installable: published with visibility restricted to your organization (is_public=false). Organization members can find and install the agent from the organization Browse tab and category pages.
  • On-Hub: published and listed on the public Agent Hub (is_public=true). Anyone can find the agent on the Agent Hub. Organization members also see it in the organization Browse tab and category pages.
Publishing with guild agent save --publish or guild agent publish makes the agent Team-installable by default.

​
What validation runs during `—wait`

`—wait` blocks until validation passes. The docs do not currently enumerate the full set of validation checks. Common failure modes called out in troubleshooting:
  • TypeScript errors in `agent.ts`
  • Saving without being inside an agent directory (one with a `guild.json` file)
If validation fails, check the latest version and save again: 
guild agent versions --limit 1
guild agent save --message "Fix validation error" --wait

​
What appears in the Agent Hub listing

The docs do not currently specify which fields appear in the Hub listing and where each one comes from in the agent source.

​
Update a published agent

To update an agent, save a new version and publish it: 
guild agent save --message "Update behavior" --wait --publish
To inspect status and version history: 
guild agent get
guild agent versions

​
Unpublish

To unpublish the latest published version: 
guild agent unpublish

​
View your published agent in the UI

Open app.guild.ai, go to Agents, then click Add agent to browse the Agent Hub.