Question 1

Can Jev read my receipts, or only the text I type?

Accepted Answer

Only the text. Jev receives the amount, merchant, purchase date, and description, plus the valid benefit/category pairs Forma returns, and never the receipt images. Inferring a claim end to end from a receipt, benefit and category included, still goes through the configured vision-capable LLM.

Question 2

What happens when Jev is unsure or the key is wrong?

Accepted Answer

Two different paths, deliberately. Below 0.5 confidence, or when no available category matches, Formanator visibly falls back to the configured OpenAI-compatible provider or the GitHub Copilot CLI. TypeSafe authentication and API errors are reported directly instead of silently falling back, so a bad key does not quietly turn into a guess.

Question 3

Will it submit claims without asking me?

Accepted Answer

Not by default. The CLI asks you to confirm inferred claim details before submitting, and a bulk directory run confirms each receipt, moving successfully submitted files into processed/. Adding --yolo skips that confirmation, and the MCP create_claim tool can also submit without a prompt.

Question 4

Is this a Jev project or an LLM project?

Accepted Answer

Mostly an LLM project. Receipt analysis defaults to the GitHub Copilot CLI, which it finds on PATH, or to any OpenAI-compatible endpoint through OPENAI_API_KEY, OPENAI_BASE_URL, and OPENAI_MODEL. Jev is opt-in per claim with --category-provider jev, or once with FORMANATOR_CATEGORY_PROVIDER=jev.

Question 5

How do I install Formanator?

Accepted Answer

On macOS or Linux with Homebrew: brew tap timrogers/tap && brew install formanator. Any platform with Rust: cargo install formanator. You can also download a release binary for macOS, Linux or Windows. v2.x is Rust; the older TypeScript 2.x build is still available through npm.

Question 6

How do I submit many receipts at once?

Accepted Answer

Run formanator submit-claims-from-directory --directory input/. It analyses every .jpg, .jpeg, .png, .pdf and .heic receipt up front with a progress bar, asks you to confirm each inferred claim, and moves submitted files into processed/. Add --yolo to submit each one as soon as it is analysed.

Question 7

Can Formanator run as an MCP server for other agents?

Accepted Answer

Yes. It runs as an MCP server over stdio and exposes six tools: auth_status, login_start, login_complete, list_benefits_with_categories, list_claims and create_claim. MCP clients such as Copilot CLI, VS Code or Claude Code can then work with your Forma account programmatically.

Formanator

About this project

Highlights

Quickstart

Questions about this entry

Reactions & coverage

From the Jev guides

From the Jev AI model community