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")' /dataGet output as JSON:
golem agent files 'CounterAgent("c1")' --format jsonagent 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. Use - to stream raw bytes to stdout. 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.txtSave to an explicit local path:
golem agent file-contents 'CounterAgent("c1")' /data/log.txt --output ./downloads/counter.logStream the raw bytes to stdout (progress messages remain on stderr):
golem agent file-contents 'CounterAgent("c1")' /data/log.txt --output -Get machine-readable metadata about the saved file:
golem --format json agent file-contents 'CounterAgent("c1")' /data/log.txt --output ./downloads/counter.logStructured 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.