Files

Overview

The oblien files command provides full file management for workspace runtimes: listing, reading, writing, deleting, and streaming directory contents.

Commands

List Files

oblien files ls <ws-id> [path]

Lists files in a directory (defaults to /). Returns a formatted table with name, size, and modified date.

Stream File Listing

oblien files stream-ls <ws-id> [path] [--recursive]

Streams file entries as NDJSON. Use --recursive to walk subdirectories.

Read a File

oblien files cat <ws-id> <path>

Prints file contents to stdout. Pipe-friendly — use with > to save locally:

oblien files cat ws_abc123 /app/config.json > config.json

Write a File

# From a flag
oblien files write <ws-id> <path> --content '{"port": 3000}'

# From a local file
oblien files write <ws-id> <path> --file ./local-file.txt

# From stdin (pipe)
echo "hello world" | oblien files write <ws-id> /app/hello.txt
cat package.json | oblien files write <ws-id> /app/package.json

When reading from an interactive terminal without --content or --file, a hint is shown. Press Ctrl+D to end input.

Delete a File or Directory

oblien files rm <ws-id> <path>

Get File Info

oblien files stat <ws-id> <path>

Returns metadata (size, type, permissions, timestamps).

Create a Directory

oblien files mkdir <ws-id> <path>

Examples

oblien files ls ws_abc123 /app
oblien files cat ws_abc123 /app/index.js
oblien files write ws_abc123 /app/config.json --content '{"debug": true}'
oblien files write ws_abc123 /app/main.py --file ./main.py
oblien files rm ws_abc123 /app/tmp
oblien files mkdir ws_abc123 /app/logs
oblien files stream-ls ws_abc123 /app --recursive

On this page