| name | golem-view-agent-files |
| description | Listing files in an agent's virtual filesystem. Use when browsing or inspecting files stored by a running agent instance. |
Viewing Agent Files
Both golem and golem-cli can be used — all commands below work with either binary.
The <AGENT_ID> format depends on the agent's language — refer to the language-specific invocation skills for the exact syntax.
agent files — List Files in an Agent's Directory
golem agent files <AGENT_ID> [PATH]
Lists the files and directories in the given agent's virtual filesystem. If [PATH] is omitted it defaults to / (the root directory).
Arguments
| Argument | Description |
|---|
<AGENT_ID> | The agent to inspect, e.g. CounterAgent("c1") |
[PATH] | Directory path to list (default: /) |
Examples
List everything under the root directory:
golem agent files 'CounterAgent("c1")'
List files in a specific subdirectory:
golem agent files 'CounterAgent("c1")' /data
Get output as JSON:
golem agent files 'CounterAgent("c1")' --format json
agent file-contents — Download a File from an Agent
golem agent file-contents <AGENT_ID> <PATH> [--output <LOCAL_FILE>]
Downloads one file from the agent's virtual filesystem and saves it to the host filesystem.
Arguments
| Argument | Description |
|---|
<AGENT_ID> | The agent to inspect, e.g. CounterAgent("c1") |
<PATH> | Absolute file path inside the agent filesystem, e.g. /data/log.txt |
--output <LOCAL_FILE> | Local host path to write. If omitted, the file is saved in the current directory using the guest file basename, or output.bin if no basename is available. |
Examples
Save /data/log.txt as ./log.txt in the current directory:
golem agent file-contents 'CounterAgent("c1")' /data/log.txt
Save to an explicit local path:
golem agent file-contents 'CounterAgent("c1")' /data/log.txt --output ./downloads/counter.log
Get machine-readable metadata about the saved file:
golem --format json agent file-contents 'CounterAgent("c1")' /data/log.txt --output ./downloads/counter.log
Structured output uses $type: "agent.file-contents" and reports fields such as saved, outputPath, and bytes. The file bytes are written to the host file, not embedded in the structured output document.
