# ro

Export Salesforce data to files.

## Usage

```bash
# Back up all objects
ro -e login.salesforce.com

# Back up using the OAuth Username/Password flow
ro -e login.salesforce.com -u username@org.example.com -p passwordToken \
   --connected-app=$CONSUMER_KEY --consumer-secret=$CONSUMER_SECRET

# Back up using the OAuth Device Flow (headless)
ro -e login.salesforce.com --device-flow

# Back up specific objects
ro Opportunity My_Custom_Object__c Document

# Export to different formats
ro --format csv
ro --format json
ro --format parquet

# Back up to a database
ro -D backup.db
```

## Why use ro?

- **Fast**: Parallel processing, optimized queries
- **Flexible**: CSV, JSON, Parquet output formats
- **Reliable**: Handles API limits, retries failed requests
- **Simple**: One command to export any object

## Installation

If you use [Homebrew](https://brew.sh/), install ro with:

```bash
brew install octoberswimmer/tap/ro
```

Otherwise, download the latest version of ro from the [releases page](https://github.com/octoberswimmer/ro-dist/releases).

## Pricing

$100/month per org. 7-day trial. Download to get started.

> ro is free to use in Salesforce sandbox orgs; production licensing is managed within the app.

## Docs

- [Docs →](/content/tools/ro/docs/index.html)

## Changelog

[See what’s new →](/content/tools/ro/changelog/index.html)