A standalone command-line version of Soulver for macOS.
Evaluate expressions, use an interactive session, or read and edit Soulver sheetbooks from the terminal and from scripts.
$ soulver "25% off 159.99 + 10% tax"
131.99175
$ soulver "98 USD in EUR"
€84.67
$ echo "5 days from now" | soulver
28 July 2026 at 8:36 ambrew install --cask soulver-cliThe Homebrew token stays soulver-cli (a bare soulver would mean the Mac app); the installed command is just soulver.
Or download the latest signed, notarized binary from the Releases page and place soulver somewhere on your PATH.
The Soulver app also bundles a copy, installed from Soulver → Install Command Line Tool…. That copy runs inside the app's sandbox, so it evaluates expressions but cannot read or edit sheetbooks; the sheetbook commands below need the Homebrew or downloaded build.
Upgrading from a 1.x Homebrew install: if soulver exits at once naming a leftover SoulverCore_SoulverCore.bundle in /opt/homebrew/bin, delete that folder. The 1.x cask put it there and 2.x cannot use it.
Pass an expression as an argument, or pipe it in:
soulver '$1,000 for 3 years at 7% compounded quarterly'
soulver "12 feet in cm"
echo "150 GBP + 200 USD in AUD" | soulverGive it a file and every line is evaluated:
soulver ~/Desktop/budget.txtUse --locale for locale-aware parsing and formatting:
soulver --locale de_DE "1.000,50 + 1" # 1001,5Other flags, on soulver "…" and soulver eval "…" alike:
| Flag | Effect |
|---|---|
--strict |
Exit 1 on anything not understood, instead of reading past it |
--auto-convert |
Convert a lone result to its counterpart: 20 C → 68 °F |
--dp <n> |
Decimal places |
--json |
{"ok": true, "expression": "2+2", "result": "4"} |
--offline |
Never refresh currency rates |
--path <file> |
The sheetbook whose definition sheet and global variables apply |
--no-definitions |
The stock engine, no sheetbook |
Expressions are evaluated with your sheetbook's definition sheet and global variables, so a unit or variable defined in the app works here too.
Rates are fetched from Soulver's rate service and cached in ~/.config/soulver/currency-rates.json; each release also includes the rates from the day it was built. If a conversion uses rates older than 12 hours, a refresh runs in a background process and applies to the next evaluation. Evaluation never waits for the network, and expressions without a currency never use it.
soulver rates status # rates in use and their age
soulver rates refresh # fetch nowRun soulver with no arguments to enter an interactive session. Variables and
line references persist across the session:
$ soulver
>>> rent = 2400
2400
>>> rent * 12
28800
>>> line1 + 500
2900
>>> 1 BTC in USD
US$66150.61
>>> exit
Press Ctrl-D or type exit to quit.
The CLI can read and edit the same .sheetbook files the Soulver app uses. By
default it finds your active sheetbook automatically; set an explicit default with
soulver use, override per-command with --path, or via the SOULVER_SHEETBOOK
environment variable.
soulver use ~/Documents/Budget.sheetbook # set a default sheetbooksoulver sheet list # list all sheets
soulver sheet show "Budget" # print a sheet's contents
soulver sheet create "July Expenses" # add a new sheet
soulver sheet duplicate "Budget"
soulver sheet move "Budget" --to "2026" # move into a folder
soulver sheet pin "Budget"
soulver sheet archive "Old Notes"
soulver sheet delete "Scratch"
soulver sheet save-as "Budget" --output ~/Budget.slvrsoulver line list --sheet "Budget"
soulver line append --sheet "Budget" "Rent: 2400"
soulver line insert --sheet "Budget" --at 3 "Utilities: 180"
soulver line set --sheet "Budget" 2 "Rent: 2500" # set line 2
soulver line mark subtotal --sheet "Budget" 4 # mark line 4 as a subtotal
soulver line format --sheet "Budget" 1 --thousands-separators # format line 1
soulver line copy answer --sheet "Budget" --line 5 # output line 5's answer
soulver line delete --sheet "Budget" 6 # delete line 6Line behaviours for mark: expression, subtotal, timepoint, running-total, running-budget. Formatting flags for format: --thousands-separators / --no-thousands-separators, --notation / --no-notation, --precision <n>, --alignment left|center|right.
Append multiple lines from stdin:
printf 'Coffee: 4.50\nLunch: 14\nTaxi: 22' | soulver line append --sheet "Today"soulver variable list
soulver variable set hourly_rate "85 USD"
soulver variable delete hourly_rate
soulver definition show
soulver definition append "story = 3.5 m" # define a custom unitsoulver search "rent" # across all sheets
soulver search "total" --sheet "Budget" # within one sheet
soulver search "500" --jsonsoulver export txt --sheet "Budget" --output budget.txt
soulver export csv --sheet "Budget" --output budget.csv
soulver export html --sheet "Budget" --show-line-numbers --show-total --output budget.html
soulver export png --sheet "Budget" --width 800 --output budget.png
soulver export txt --sheet "Budget" --clipboard # straight to the clipboardsoulver new sheetbook --path ~/Documents/Finances.sheetbook
soulver new sheet --path ~/calc.slvrsoulver inspect line --sheet "Budget" 1 --jsonThe CLI can be driven from scripts, editor plugins, and agents:
-
--jsonon reads —sheet list,line list,search,inspect,variable list, etc. return structured JSON. -
--jsonon writes — create/append/set/mark/delete report what changed, so you can chain commands without scraping prose:id=$(soulver sheet create "Budget" --json | jq -r .id) line=$(soulver line append --sheet "$id" "Rent: 2400" --json | jq -r .line)
-
Errors go to stderr and the process exits non-zero, so failures are easy to detect.
-
Bare expressions evaluate directly:
soulver "1 + 1"(no subcommand needed).
soulver sheet list --json
soulver line list --sheet "Budget" --json
soulver inspect line --sheet "Budget" 1 --jsonsoulver --help
soulver <command> --help
soulver help <command> <subcommand>