CLI

moniary je nástroj pro práci s Moniary z příkazové řádky. Umí vyhledat a spustit akce API, nahrát doklady k vytěžení a počkat na výsledek. Výstup vrací jako JSON, takže ho snadno zpracujete nástroji jako jq a dobře si s ním poradí i AI agenti.

Instalace

Potřebujete Node.js ve verzi 20 nebo novější.

npm install -g @moniary/cli
moniary --version

Pokud nechcete nic instalovat, spusťte ho přes npx:

npx @moniary/cli login

Na novou verzi aktualizujete stejným příkazem npm install -g @moniary/cli.

Přihlášení

moniary login

Otevře se prohlížeč. Přihlaste se do Moniary, vyberte firmu a přístup (Čtení, nebo Čtení a zápis) a klikněte na Povolit přístup. CLI si vytvoří vlastní API klíč s názvem „CLI (název počítače)“. Najdete ho v Nastavení → API a CLI a tam ho také můžete kdykoli zneplatnit.

Pod jakým účtem jste přihlášení, zjistíte takto:

moniary whoami

{
  "key": {
    "name": "CLI (macbook)",
    "prefix": "mny_RTE5jErA",
    "scope": "write"
  },
  "user": { "email": "jana@firma.cz" },
  "workspace": { "name": "Firma s.r.o." }
}

Na serveru bez prohlížeče spusťte moniary login --no-browser a vypsaný odkaz otevřete na jiném zařízení. Můžete také použít API klíč, který jste vytvořili v aplikaci:

moniary login --key mny_…
echo "$MONIARY_API_KEY" | moniary login

Přihlášení se uloží do souboru ~/.config/moniary/cli.json, ke kterému máte přístup jen vy. Pro práci s jinou firmou se přihlaste znovu a vyberte ji. Příkaz moniary logout smaže přihlášení z počítače. Samotný API klíč ale platí dál, dokud ho v aplikaci nezneplatníte.

Příkazy

Spouštění akcí

Vyhledejte akci a podívejte se, jaký má vstup:

moniary actions invoice
moniary describe invoices.getInvoiceStats

Pak ji spusťte. Vstup můžete zadat jako JSON, jako dvojice klíč=hodnota nebo přes standardní vstup:

moniary run invoices.getInvoiceStats
moniary run invoices.getInvoiceStats '{"filter": {"overdue": true}}'
moniary run tags.create name="Pohonné hmoty" color='"#3b82f6"'
cat koncept.json | moniary run issuedInvoices.saveDraft -

U dvojic klíč=hodnota se hodnota čte jako JSON, pokud to jde. pageSize=20 je tedy číslo a overdue=true logická hodnota, ostatní se bere jako text. Všechny akce a jejich vstupy najdete v Referenční příručce.

Nahrávání dokladů

moniary upload faktura.pdf uctenky/*.jpg
moniary upload faktura.pdf --wait

S přepínačem --wait počká CLI na vytěžení (nejdéle 10 minut) a vypíše výsledek včetně čísel vytvořených dokladů. Bez něj vypíše uploadSessionId, podle kterého si stav zjistíte později:

moniary uploads On3iHRaS2JhErPH2Ai

Podporované soubory a limity najdete na stránce Nahrávání dokladů.

Skripty a CI

Ve skriptech a v CI se nepřihlašujte přes prohlížeč. Vytvořte si API klíč v aplikaci a předejte ho v proměnné prostředí:

export MONIARY_API_KEY=mny_…
moniary run invoices.getOverdueInvoices | jq '.[].invoiceNumber'

Výsledek se vypisuje na standardní výstup, chyby na chybový výstup. Návratový kód je 0, když vše proběhne, 1, když API vrátí chybu (třeba neplatný vstup nebo chybějící oprávnění), a 2, když příkaz použijete špatně.

AI agenti

Agenti jako Claude Code, Codex nebo Cursor umí CLI používat sami. Víc na stránce Pro AI agenty.