> For the complete documentation index, see [llms.txt](https://documentation.soulver.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.soulver.app/documentation/integrations/command-line-tool-automator-and-services.md).

# Terminal (CLI)

You can use the `soulver` command in Terminal to perform calculations using [Soulver's math engine](https://soulver.app/core):

```
$ soulver June 20 + 3 weeks
11 July
```

To install it, go to `Soulver > Integrations > Terminal (Command Line Interface)`

We add the 'soulver' alias in `/usr/local/bin/` to the command line tool inside the main Soulver app bundle.

#### Currency conversions

```
$ soulver '$100 in EUR'
€60.46
```

Use single quotes around expressions containing `$` so your shell passes the dollar sign to Soulver without treating it as a variable.

{% hint style="warning" %}
Other live data services such as weather, historical currency conversions, stock rates & knowledge assistant, are **not available** from the command line tool
{% endhint %}

### Working with sheets

The standalone CLI can create and edit Soulver sheets and work with sheetbooks. This lets scripts and AI agents populate your sheets with data and calculations.

Install it with `brew install --cask soulver-cli`, or download it from the [Soulver CLI releases](https://github.com/soulverteam/Soulver-CLI/releases). The CLI bundled with the Mac app supports calculations but cannot read or edit sheetbooks.

For example, `soulver sheet list` lists your sheets, and `soulver sheet show "Budget"` displays the contents of a sheet named Budget.

See the [Soulver CLI documentation](https://github.com/soulverteam/Soulver-CLI) for setup instructions and the full command reference.

### [Standalone CLI](https://github.com/soulverteam/Soulver-CLI)

The standalone CLI is free and does not require the Soulver Mac app.

{% hint style="info" %}
The standalone CLI downloads and caches currency rates independently; the Soulver Mac app is not required. Use `soulver rates refresh` to update rates manually, or `--offline` to use cached rates without fetching updates.
{% endhint %}