# Install soulver-cli with Homebrew Cask

Standalone cli for the Soulver calculation engine. Version 2.0.1 via Homebrew Cask; verified 2026-07-11.

## Install

```sh
sudo av install cask:soulver-cli
```

Additional install commands:

### macOS

- Homebrew Cask (100%):

```sh
brew install --cask soulver-cli
```

  Evidence: local Homebrew cask metadata

## Package facts

- **Package key:** cask:soulver-cli
- **Package manager:** Homebrew Cask
- **Version:** 2.0.1
- **Source summary:** Standalone cli for the Soulver calculation engine
- **Homepage:** <https://github.com/soulverteam/Soulver-CLI>
- **Last updated:** 2026-07-11T13:34:51Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- soulver (binary)
- soulver (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.0.1
## Project history and usage

Soulver CLI is the macOS command-line form of the Soulver calculation engine, packaged for terminal use as the `soulver` executable while Homebrew Cask keeps the token as `soulver-cli` to avoid colliding with the desktop app.

### Project history

The public GitHub repository was created in January 2023 and its first release, 1.0.0, was published the same day as an initial release. The README describes it as a standalone command-line version of Soulver for macOS, built on SoulverCore.

Version 2.0.0, published in June 2026, expanded the tool beyond expression evaluation into sheetbook manipulation, including sheets, lines, variables, search, export, and JSON-oriented inspection commands.

### Adoption history

Its official install path includes Homebrew Cask and signed notarized release binaries, matching the distribution pattern common for macOS-only developer utilities.

### How it is used

The CLI evaluates natural-language calculations from arguments, stdin, files, or an interactive session, and can read and edit Soulver `.sheetbook` files for scripting and automation.

### Why package nerds care

Package-manager users care because it turns a Mac productivity calculator into a scriptable command with stable stderr/nonzero failure behavior and JSON output for agent, editor, and shell workflows.

### Timeline

- 2023: Public GitHub repository and 1.0.0 initial release.
- 2025: 1.0.3 updated currency-rate cache handling for macOS Sequoia group-container changes.
- 2026: 2.0.0 added sheetbook manipulation, export, search, and JSON-oriented automation features.

### Related projects

- SoulverCore is the calculation engine behind Soulver and Soulver CLI.

### Sources

- <https://github.com/soulverteam/Soulver-CLI#readme>
- <https://github.com/soulverteam/Soulver-CLI/releases>


## Security Notes

No matching local secret-handling manifest was found for soulver-cli. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Combined YAML source

View the package source record on GitHub. [combined/soulver-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/soulver-cli.yml)


## Sources

- pkg.so package database
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph
