grev

grev [options] query [file ...]

grev asks a TypeSafe Jev model one yes/no question per record and prints the records it answers yes to, unchanged and in input order. A record is a line unless -z or --para says otherwise. The model does not write the output. Probabilities show up only with -s, or as the exit status when nothing was selected.Counting, context, and file names are done in the program, one answer per record. Closing the output pipe (`| head`) stops further requests.The same install is a set of filters that share this option set, one config file, and one API key. man grev-tools and man grevconfig ship with the package. Releases, a Go install (`go install github.com/aurorainfra/grev/cmd/...@latest`), and `make && sudo make install` are how the project distributes the binaries.The default model jev-1.13.0 is priced by the project at $0.042 per million input tokens. Output tokens are free. GREV_PRICE_PER_MTOK overrides the input price. A model the built-in table does not know needs a `price` under `[model "id"]` in the config.

query

Yes/no question asked of each record. `{}` stands for the record. With --delimiter, `{1}` and `{2}` are fields. A query with no placeholder is read as a predicate about the record (`is a vegan meal`).

Input files. With no file, grev reads stdin. `-` is stdin. --files-from FILE reads one path per line (`-` for stdin).

What the input is (`application log`, `git commit messages`). The largest accuracy gain.

Extra text sent with every question, such as a spec the lines are checked against.

Spell out what counts as yes and what counts as no.

Keep records the model answers no to. The decision is one minus P(yes), not a rewritten question.

Print a count of selected records per file, instead of the records.

Prefix each printed record with its record number.

Prefix records with the file name. This is already the default when more than one file is given.

Never prefix file names.

Print nothing. Exit 0 at the first selected record.

Stop after N selected records.

Print N records after each selected record.

Print N records before each selected record.

Print N records around each selected record.

Ask about each whole file and print the names of files that match. A file too large for one request is split, and any chunk that answers yes selects the file.

Ask about each whole file and print the names of files that do not match.

Prefix each printed record with P(yes).

Select when P(yes) is at least P. Default 0.5. Inside --band, yes means strictly above the high end.

Treat LO ≤ P(yes) ≤ HI as uncertain: neither selected nor rejected. If only uncertain records remain, the exit status is 3.

Write uncertain records to FILE. Implies --band `0.3:0.7` when --band is omitted.

Show the model N neighbouring records on each side. With --line-buffered, each record waits until N later records have arrived.

Split each record on DELIM into fields `{1}`, `{2}`, and so on. Escapes such as `\t` are recognized.

Records are NUL-terminated instead of lines.

Records are paragraphs separated by blank lines.

Answer and print records as they arrive. For `tail -f` and `journalctl -f`.

With --line-buffered, send a partial request after this duration. Default `250ms`.

Progress, cost, and a projection on stderr. WHEN is `always`, `never`, or `auto`. --progress without a value means `always`.

Print the quote (requests, tokens, cost) and ask before sending anything.

Ask first when a run is quoted above this many US dollars. `off` never asks. The built-in default is 1. A quote above the limit with no terminal exits 4.

How many requests run at once. N is a number, or `max` to follow the server. Default 4.

Refuse or stop once this run would spend more than USD. `off` disables the cap. An explicit cap that covers the quote counts as a yes at the confirm prompt.

Model id. Otherwise `api.model`, then TYPESAFE_DEFAULT_MODEL, then the built-in jev-1.13.0.

grev reads `${XDGCONFIGHOME:-~/.config}/grev/config`, then `~/.grevconfig`. Later values win. GREV_CONFIG=PATH replaces both files. An empty GREV_CONFIG turns config off. `[include] path` reads another file, relative to the one that names it. There is no per-project config: a repository is not allowed to point `api.endpoint` somewhere else.The syntax is a subset of git config. `[section]` and `[section "subsection"]` headers, `key = value`, `#` and `;` comments, quoted values, and a trailing `\` to continue a line. A bare key means true. Section and key names ignore case and dashes, so `maxCost`, `max-cost`, and `maxcost` are one key.jev key set writes `api.key` into `~/.grevconfig` and keeps the mode 0600. The tools warn if anyone else can read the file. api.keyCommand runs a command (for example `pass show typesafe/api`) instead of storing the key. For automation the key is taken from the first of TYPESAFE_API_KEY, TYPESAFE_API_KEY_FILE, and `$CREDENTIALSDIRECTORY/typesafeapi_key`. Those beat the file. jev key import copies a key from those variables into `~/.grevconfig`.Precedence on one run is the command-line flag, then the environment, then `[tool "grev"]`, then `[defaults]`, then the built-in. --no-progress and --no-scores turn a boolean off for one run.Spend is added to `${XDGSTATEHOME:-~/.local/state}/grev/spend`. GREV_LEDGER moves that file; an empty GREV_LEDGER turns the ledger and the daily and monthly caps off. jev spend prints today's and this month's spend by tool against `limits.daily` and `limits.monthly`.

$ [api]
keyCommand = pass show typesafe/api
[defaults]
progress = auto
jobs = max
confirmAbove = 0.25
[limits]
daily = 5
monthly = 50
[tool "grev"]
about = application logs
threshold = 0.7

isv query

One yes/no question about the whole input. Exit 0 is yes, 1 is no. Prints nothing unless -s.

Print which label fits the whole input.

Label every record. --split DIR routes records into one file per label.

Sort by a pairwise comparison described in words.

Order records by how well they fit, or by named levels.

Print the one line, or regex match, that best answers a question.

Collapse adjacent records that mean the same thing.

Rejoin hard-wrapped lines.

Split a stream into topic segments.

Keep the CSV or TSV columns that match a description.

Walk a directory tree to the path a description names.

Translate, delete, squeeze, or replace only where an instruction applies.

Find the first place an ordered input's answer flips, in a few rounds.

Print per-record probability columns for awk.

API key, config, spend, and one-off requests: jev key set, jev key status, jev config set, jev spend.

Every match is a request to the TypeSafe API. grev does not run offline. The text you pass is what the model sees.Exit status 0 means a record was selected, 1 means none, 2 is an error, 3 means only uncertain records (--band), and 4 means the run was declined at -Q or stopped by --max-cost or a spend cap. Interrupt is 130.A run quoted above --confirm-above asks on a terminal and refuses without one. --max-cost set high enough to cover that quote is itself the acceptance. Daily and monthly caps refuse before the prompt when the quote would pass them.-J defaults to 4, not to `max`. `jobs = max` in the config is what removes the cap.

grep(1), awk(1), sort(1), cut(1), uniq(1)

Source code · Documentation