The invoice.bot desktop app: a secure browser harness that signs in to supplier portals, fetches new invoices and delivers them to finance apps such as nevermind.finance. It runs on a computer you trust, keeps logins, passkeys and second-factor seeds in an encrypted vault, and never shows a secret to the model provider. This app is distributed outside the Mac App Store; the store version for macOS, iPadOS and iOS is invoice.bot/swiftapp.

Issue Reporting and Security

For reporting bugs, issues, or security vulnerabilities, please visit community.foss.global/. This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a code.foss.global/ account to submit Pull Requests directly.

Status

Early. The app is an Electron shell with a hardened main window. Repository architecture and security rules are in AGENTS.md; local work plans stay in .nogit/readme.plan.md.

Development

pnpm install
pnpm run build   # tsbuild (ts/, ts_web/, ts_dev/) and tsbundle (dist_bundle/, dist_bundle_dev/)
pnpm test
pnpm start       # build and open the app; needs a desktop session
pnpm run make    # on macOS: DMG and ZIP through Electron Forge

The window also opens in a plain browser against a mock backend: after pnpm run build, serve the repository (python3 -m http.server 3050 --bind 127.0.0.1) and open http://127.0.0.1:3050/html_dev/?state=unlocked. state=none starts at setup, state=locked at unlock; AGENTS.md lists the other switches.

Layout

ts/ — the Electron main process: the app's lifecycle and its main window.
ts_web/ — the app's window (dees-catalog), bundled to dist_bundle/bundle.js.
ts_dev/, html_dev/ — the dev page: the window against a mock backend, bundled to dist_bundle_dev/bundle.js; not part of the app.
html/index.html — the app document, with a strict content security policy.
test/ — tstest tests.

License and Legal Information

This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the license.md file.

Please note: The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.

Trademarks

This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.

Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.

readme.md

@invoice.bot/mainapp