Artifacts

gumloop artifacts exposes the files an agent has produced, such as reports, generated docs, and exported data. Artifacts are always scoped to an agent.

List artifacts

gumloop artifacts list agent_abc
gumloop artifacts list agent_abc --session session_xyz --limit 50

Prints ID, FILENAME, VERSION, SESSION, and CREATED. If there are more results, the CLI prints the next cursor at the bottom.

Grab the agent ID from gumloop agents list and the session ID from gumloop sessions get <id> or the URL of the session in the Gumloop hub.

Flag	Description
`--session`	Filter to artifacts produced inside a specific session.
`--limit`	Maximum number of artifacts to return.
`--cursor`	Pagination cursor from a previous list call.
`--json`	Print the raw response payload.

Download an artifact

gumloop artifacts download artifact_abc

By default the CLI writes the artifact to the current directory under its original filename. Use -o to change the destination:

Flag	Description
`-o`, `--output`	File or directory to write to. Use `-` to write to stdout.
`--version-id`	Download a specific artifact version.
`--json`	Print download metadata as JSON (path + bytes).

gumloop artifacts download artifact_abc -o ./downloads/
gumloop artifacts download artifact_abc -o -                  # stream to stdout
gumloop artifacts download artifact_abc --version-id av_xyz

Inspect and manage files

gumloop artifacts get artifact_abc --json
gumloop artifacts versions artifact_abc --json
gumloop artifacts rename artifact_abc --name "report.md" --json
gumloop artifacts delete artifact_abc --json

get calls the existing SDK artifacts.download method and returns download metadata plus its signed URL without transferring file bytes. versions discovers version history. Use the existing download command above for bytes, including a specific --version-id. Rename changes a legacy file’s display name while preserving its stored filename; --reset clears the display name. VFS files cannot be renamed or deleted through these methods. Deletion soft-deletes a legacy generated file. Python equivalents are client.artifacts.download, list_versions, rename, and delete; download accepts version_id. There is no separate SDK retrieve or content method. These methods require the corresponding backend API support. Hosting, version restoration, and script execution remain outside this client surface.

SDKs

Gumloop for terminal

List artifacts

Download an artifact

Inspect and manage files

​List artifacts

​Download an artifact

​Inspect and manage files

List artifacts

Download an artifact

Inspect and manage files