List and download invoices via iret client mode only. Always delegate to a trusted proxy server using IRET_PROXY_URL.
CLI for listing and downloading invoices from supported sites.
Scope: this tool interfaces with supplier sites (vendor billing pages). It is not for accounting software invoice export/download flows.
This system has two parts:
iret client CLI: used by the agent on an untrusted machineiret proxy server: started by a human on a trusted machine with browser accesshttps://github.com/marcinbogdanski/invoice-retrieverhttps://raw.githubusercontent.com/marcinbogdanski/invoice-retriever/refs/heads/main/README.mdhttps://raw.githubusercontent.com/marcinbogdanski/invoice-retriever/refs/heads/main/skills/iret/SKILL.mdIRET_PROXY_URL set.iret proxy../start-chrome-browser.sh.IRET_PROXY_URL is missing or proxy is unreachable, stop and ask user to start/fix proxy.IRET_PROXY_URL=http://trusted-host:8765 iret obsidian list
IRET_PROXY_URL=http://trusted-host:8765 iret obsidian get <invoice_id>
IRET_PROXY_URL=http://trusted-host:8765 iret obsidian get <invoice_id> --out-dir ~/Downloads
The user manages proxy setup. If needed, direct them to README.
list prints one line per invoice:
<invoice_id> | <date> | amount_cents=<amount> | <description>get prints the saved local PDF path on success.~/Downloads unless --out-dir is provided.get saves as name (1).pdf, name (2).pdf, etc.GET /healthzGET /v1/obsidian/listGET /v1/obsidian/get/<invoice_id>