aether file

Manage files in a running workspace. All file operations run over a WebSocket connection to the workspace. Alias: files

Usage

aether file <subcommand> [flags]

Every subcommand accepts the persistent --workspace flag to target a specific workspace. When omitted, the command uses the project’s single running workspace.

Flag	Description
`--workspace`	Workspace ID (defaults to the project’s running workspace)

Subcommands

Subcommand	Description
`list [path]`	List files and directories
`read <path>`	Read file contents
`write <path>`	Write content to a file
`mkdir <path>`	Create a directory
`delete <path>`	Delete a file or directory
`rename <old> <new>`	Rename or move a file
`stat <path>`	Show file metadata

aether file list

List files and directories at the given path. Defaults to the workspace root. Directories are listed first, then files, alphabetically within each group.

aether file list [path]

aether file list src/

TYPE    NAME            SIZE      MODIFIED
dir     components      —         2m ago
file    index.ts        1.2 KB    5m ago
file    config.ts       320 B     1h ago

aether file read

Read the contents of a file and print it to stdout.

aether file read <path> [flags]

Flag	Description
`--encoding`	File encoding, `utf8` or `base64`. Defaults to `utf8`.

aether file read src/index.ts

# Read a binary file as base64
aether file read assets/logo.png --encoding base64

aether file write

Write content to a file, creating it if it does not exist or overwriting it if it does. Provide the content with --content, or pipe it on stdin.

aether file write <path> [flags]

Flag	Description
`--content`	File content. If omitted, content is read from stdin.
`--encoding`	Content encoding, `utf8` or `base64`. Defaults to `utf8`.

aether file write src/config.ts --content 'export const PORT = 3000;'

# Pipe content from stdin
cat new-file.ts | aether file write src/new-file.ts

aether file mkdir

Create a directory.

aether file mkdir src/components/ui

aether file delete

Delete a file or directory.

aether file delete <path> [flags]

Flag	Description
`--force`	Skip the confirmation prompt

aether file delete src/old-module.ts

aether file rename

Rename or move a file or directory.

aether file rename src/utils.ts src/helpers.ts

aether file stat

Show metadata for a file or directory: path, type, size, and modified time.

aether file stat src/index.ts

CLI Reference

Core Commands

Account Commands

Workspace Commands

Integration Commands

Provider Auth

Configuration

Usage

Subcommands

aether file list

aether file read

aether file write

aether file mkdir

aether file delete

aether file rename

aether file stat

​Usage

​Subcommands

​aether file list

​aether file read

​aether file write

​aether file mkdir

​aether file delete

​aether file rename

​aether file stat

Usage

Subcommands

aether file list

aether file read

aether file write

aether file mkdir

aether file delete

aether file rename

aether file stat