Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Display build and validation step logs for an agent version.
guild agent logs retrieves and displays the build and validation step logs for an agent version. Use it to inspect TypeScript compiler output and other validation details without running a full guild agent save --wait cycle.
guild agent logs [identifier] [version-id]
| Argument | Description |
|---|---|
[identifier] | Agent ID or full name (e.g., owner~agent-name). If omitted, reads from guild.json in the current directory. |
[version-id] | ID of the version whose logs to display. If omitted, uses the latest version. |
| Option | Description |
|---|---|
--json | Output raw JSON instead of formatted text (global flag). |
build SUCCEEDED
────────────────────────────────────────────────────────────
validate FAILED
src/index.ts(12,5): error TS2345: ...
src/index.ts(27,3): error TS7006: ...
No steps found.
| Condition | Exit code | Resolution |
|---|---|---|
| Not authenticated | 1 | Run guild auth login. |
| Agent or version not found | 1 | Run guild agent list or guild agent versions <agent-id>. |
| Cannot connect to server | 1 | Check your connection and run guild doctor. |
guild agent logs
guild agent logs owner~my-agent
guild agent logs owner~my-agent <version-id>
guild agent logs after a failed guild agent save --wait or guild agent revalidate to re-inspect step details without triggering a new save.