pull
Download the agent's workspace files from a running sandbox to your local machine, excluding ClawRun-managed config files.
Usage
clawrun pull <instance>Pull agent runtime state from the sandbox to your local machine. The sandbox must already be running. This command does not start a stopped sandbox.
Arguments
| Argument | Required | Description |
|---|---|---|
instance | Yes | The instance name |
Behavior
- Connects to the running sandbox
- Determines the agent's home directory via
echo $HOME - Lists all files under the agent's runtime directory (
$HOME/{sandboxRoot}/agent/) - Filters out "locally owned" files, which are configuration files managed by ClawRun (e.g.,
config.toml) that the agent declares viagetLocalOwnedFiles(). These are excluded because they are generated by the CLI and should not be overwritten - Downloads remaining files via
readFile()and writes them to the local instance directory
Files are saved to ~/.clawrun/<instance-name>/agent/, mirroring the sandbox directory structure. The command prints a summary with the count of files pulled and the local destination path.
If no pullable files are found (only locally-owned files exist), the command warns and exits.
Examples
clawrun pull my-instance