fs - Bonya

`bonya fs`

Reads and writes files inside a sandbox. Every subcommand names its sandbox by name or id, interchangeably, and omitting it opens a picker:

bonya fs ls web /workspace
bonya fs ls /workspace        # prompts for the sandbox

All nine subcommands accept --by-name to force name interpretation of the sandbox argument.

`read` (alias: `cat`)

Prints a remote file to stdout.

bonya fs read [sandbox] <path>

bonya fs read web /etc/hostname
bonya fs cat web /etc/hostname

`write`

Writes a local file — or stdin, with - — to a remote path.

bonya fs write [sandbox] <path> <local-file-or-->

Argument order is remote path, then local source — the opposite order from upload. write exists mainly for piping stdin straight to a remote file; upload exists for local-file-to-remote-file with the more intuitive source-then-destination order.

bonya fs write web /workspace/notes.txt ./notes.txt

echo 'hello' | bonya fs write web /workspace/hello.txt -

`upload`

Uploads a local file to a remote path. Source, then destination — the familiar order.

bonya fs upload [sandbox] <local> <remote>

bonya fs upload web ./dist.tar.gz /workspace/dist.tar.gz

`download`

Downloads a remote file to a local path.

bonya fs download [sandbox] <remote> <local>

bonya fs download web /workspace/output.log ./output.log

`ls`

Lists a remote directory.

bonya fs ls [sandbox] <path>

bonya fs ls web /workspace

On a real terminal, bonya fs ls looks like this:

`stat`

Shows metadata (kind, size, mode, modified time) for a remote path.

bonya fs stat [sandbox] <path>

bonya fs stat web /workspace/app.py

`mkdir`

Creates a remote directory.

bonya fs mkdir [sandbox] <path>

bonya fs mkdir web /workspace/logs

`rm`

Removes a remote file or directory.

bonya fs rm [sandbox] <path> [--recursive]

Flag	Default	Description
`--recursive`	`false`	Remove directories recursively.

bonya fs rm web /workspace/tmp.txt
bonya fs rm web /workspace/build --recursive

`mv`

Moves (renames) a remote file or directory.

bonya fs mv [sandbox] <src> <dst>

bonya fs mv web /workspace/draft.md /workspace/final.md

All subcommands at a glance

Command	Arguments	Notes
`read` (`cat`)	`<path>`	Prints to stdout.
`write`	`<path> <local-or-->`	Remote path first, source second.
`upload`	`<local> <remote>`	Source first, remote path second.
`download`	`<remote> <local>`
`ls`	`<path>`
`stat`	`<path>`
`mkdir`	`<path>`
`rm`	`<path>`	`--recursive` for directories.
`mv`	`<src> <dst>`

Overview

Getting started

Sandboxes

Inside a sandbox

Account

fs

`bonya fs`

`read` (alias: `cat`)

`write`

`upload`

`download`

`ls`

`stat`

`mkdir`

`rm`

`mv`

All subcommands at a glance

​bonya fs

​read (alias: cat)

​write

​upload

​download

​ls

​stat

​mkdir

​rm

​mv

​All subcommands at a glance

`bonya fs`

`read` (alias: `cat`)

`write`

`upload`

`download`

`ls`

`stat`

`mkdir`

`rm`

`mv`

All subcommands at a glance