Skip to main content

​
Commands

CommandPurpose
goldenflow transform <file>Zero-config auto-detect and fix.
goldenflow <file>Shorthand that routes to transform.
goldenflow -Read from stdin, write to stdout.
goldenflow map --source a.csv --target b.csvAuto-map schemas between files.
goldenflow profile <file>Show column profiles.
goldenflow learn <file> -o config.yamlGenerate a config from data patterns.
goldenflow validate <file>Dry-run: show what would change.
goldenflow diff before.csv after.csvCompare pre/post transform.
goldenflow watch ./data/Auto-transform new or changed files.
goldenflow schedule <file> --every 1hRun on a schedule (5m, 1h, 30s…).
goldenflow stream large_file.csv --chunk-size 50000Stream-process in batches.
goldenflow init <file>Interactive setup wizard.
goldenflow demoGenerate sample data to try.
goldenflow history [-n 50]Show recent transform runs.
goldenflow interactive <file>Launch the TUI.
goldenflow serveREST API for real-time transforms.
goldenflow mcp-serveMCP server for Claude Desktop.

​
Key flags

FlagEffect
--domain healthcare|people_hr|finance|ecommerce|real_estateApply a domain pack.
--strictFail on the first transform error (exit 1).
--llmEnable LLM-enhanced corrections.
-c <config.yaml>Load an explicit config.
-o <output_path>Output directory or file.
--every <interval>Scheduling interval.
--chunk-size <N>Streaming batch size.

​
Config

source: customers.csv
output: customers_clean.csv

transforms:
  - column: name
    ops: [strip, title_case]
  - column: email
    ops: [lowercase, strip]
  - column: phone
    ops: [phone_e164]

renames:
  email_address: email
  phone_number: phone

drop: [internal_id, temp_notes]

dedup:
  columns: [email]
  keep: first

​
Environment variables

VariableEffect
OPENAI_API_KEYLLM-enhanced categorical corrections (with --llm).
ANTHROPIC_API_KEYAlternative LLM provider.
GOLDENFLOW_LLM=1Enable LLM mode programmatically.
Transform runs are saved to ~/.goldenflow/history/ as JSON.