---
name: "bean-query"
section: "1"
platform: "linux"
package: "beancount"
version: "2.3.5-2"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/bean-query"
---

# bean-query(1)

interactive shell for the Beancount Query Language

## NAME

bean-query - interactive shell for the Beancount Query Language

## DESCRIPTION

usage: bean-query \[-h\] \[--version\] \[-f {text,csv}\] \[-m\] \[-o OUTPUT\] \[-q\]

-

  FILENAME.beancount \[query ...\]

An interactive command-line shell interpreter for the Beancount Query Language.

### positional arguments:

- FILENAME.beancount

  The Beancount input filename to load

- query

  A query to run directly

### options:

- **-h**, **--help**

  show this help message and exit

- **--version**, **-V**

  show program's version number and exit

- **-f** {text,csv}, **--format** {text,csv}

  Output format.

- **-m**, **--numberify**

  Numberify the output, removing the currencies.

- **-o** OUTPUT, **--output** OUTPUT

  Output filename. If not specified, the output goes to stdout. The filename is inspected to select a sensible default format, if one is not requested.

- **-q**, **--no-errors**

  Do not report errors
