File Operations

hopx files <subcommand> [options]

hopx files read SANDBOX_ID PATH [OPTIONS]

# Read file
hopx files read sb_abc123 /app/config.json

# Read with JSON output
hopx files read sb_abc123 /app/data.txt --output json

{"key": "value"}

hopx files write SANDBOX_ID PATH [OPTIONS]

# Write file with data
hopx files write sb_abc123 /app/config.json --data '{"key": "value"}'

# Write from stdin
echo "Hello, World!" | hopx files write sb_abc123 /app/data.txt --data -

# Write from file
cat local.txt | hopx files write sb_abc123 /app/data.txt --data -

✓ File written: /app/config.json

hopx files list SANDBOX_ID [PATH] [OPTIONS]

# List files in workspace
hopx files list sb_abc123

# List files in specific directory
hopx files list sb_abc123 /app/

# List with JSON output
hopx files list sb_abc123 --output json

┌──────────────┬──────┬─────────────────────┐
│ Name         │ Size │ Modified            │
├──────────────┼──────┼─────────────────────┤
│ config.json  │ 234  │ 2025-01-27 10:00:00 │
│ data.txt     │ 13   │ 2025-01-27 10:00:00 │
└──────────────┴──────┴─────────────────────┘

hopx files delete SANDBOX_ID PATH [OPTIONS]

# Delete file
hopx files delete sb_abc123 /app/temp.txt

# Delete without confirmation
hopx files delete sb_abc123 /app/temp.txt --force

✓ File deleted: /app/temp.txt

hopx files upload SANDBOX_ID LOCAL_PATH REMOTE_PATH [OPTIONS]

# Upload local file
hopx files upload sb_abc123 ./local.txt /app/remote.txt

# Upload with progress
hopx files upload sb_abc123 ./large.csv /app/data.csv

✓ File uploaded: /app/remote.txt

hopx files download SANDBOX_ID REMOTE_PATH LOCAL_PATH [OPTIONS]

# Download file
hopx files download sb_abc123 /app/data.txt ./local.txt

# Download with progress
hopx files download sb_abc123 /app/result.csv ./result.csv

✓ File downloaded: ./local.txt

hopx files info SANDBOX_ID PATH [OPTIONS]

# Get file info
hopx files info sb_abc123 /app/config.json

# Get info with JSON output
hopx files info sb_abc123 /app/data.txt --output json

┌─────────────┬─────────────────────────────────────┐
│ Property    │ Value                               │
├─────────────┼─────────────────────────────────────┤
│ Name        │ config.json                         │
│ Path        │ /app/config.json                    │
│ Size        │ 234 B                               │
│ Type        │ file                                │
│ Modified    │ 2025-01-27 10:00:00                 │
└─────────────┴─────────────────────────────────────┘

#!/bin/bash
set -e

SANDBOX_ID="sb_abc123"

# Upload file
hopx files upload "$SANDBOX_ID" ./data.csv /app/data.csv

# Process file
hopx run "import pandas as pd; df = pd.read_csv('/app/data.csv'); print(df.head())" --sandbox "$SANDBOX_ID"

#!/bin/bash

# Download file
hopx files download sb_abc123 /app/results.json ./results.json

# Process locally
jq '.summary' ./results.json

#!/bin/bash

# List files and download each
hopx files list sb_abc123 /app/ --output json | jq -r '.[].name' | while read file; do
    echo "Downloading $file..."
    hopx files download sb_abc123 "/app/$file" "./$file"
done