Menu
Listing files in an agent's virtual filesystem. Use when browsing or inspecting files stored by a running agent instance.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Adding secrets to MoonBit Golem agents. Use when the user asks to add secret values, API keys, or sensitive configuration to a MoonBit agent.
Adding secrets to Rust Golem agents. Use when the user needs to store sensitive configuration such as API keys, passwords, or tokens that should not be checked into source control.
Adding secrets to Scala Golem agents. Use when the user asks to add secret values, API keys, passwords, or sensitive configuration to a Scala Golem agent.
Adding secrets to TypeScript Golem agents. Use when the user asks to add secrets, store API keys, manage sensitive config values, or use Secret<T> in TypeScript agents.
Adding or changing application manifest JSON schema versions and aligning CLI schema references.
Adding or modifying WIT (WebAssembly Interface Types) interfaces. Use when changing .wit files, updating WIT dependencies, or working with component interfaces.
| 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. |
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 Directorygolem 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).
| Argument | Description |
|---|---|
<AGENT_ID> | The agent to inspect, e.g. CounterAgent("c1") |
[PATH] | Directory path to list (default: /) |
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 Agentgolem 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.
| 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. |
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.