# `smallforce workspace write`

Write one UTF-8 text file into the workspace

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.8. Run `smallforce workspace write --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce workspace write [options] <path>

Write one UTF-8 text file into the workspace

Arguments:
  path                   POSIX workspace-relative destination path

Options:
  --content <text>       Inline UTF-8 text
  --content-file <path>  Read UTF-8 text from a local file, or - for stdin
  --overwrite            Replace the exact file when it already exists
  --api-key <key>        SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>    SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                 Print stable machine-readable JSON
  --text                 Print human-readable text
  --format <format>      Output format: text or json
  -h, --help             display help for command
```

## Related reference

- [`smallforce workspace`](/docs/cli/commands/workspace): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.