Uzavřete měsíc přímo z terminálu

Konec měsíce má svůj rytmus: sečíst hodiny, srovnat peníze, dohnat faktury, uložit čísla. Pokud už žijete v terminálu, proklikávat se za tím obrazovkami je ta pomalá cesta. Ceum CLI (@ceum/cli) řídí stejné operace jako aplikace – takže se celá rutina promění v hrstku příkazů, které si příští měsíc přečtete zpátky, nebo předáte cronu.

Tento průvodce sleduje jeden konkrétní úkol – uzavření měsíce – od prázdného shellu k reportu, který můžete založit. Nastavení v kroku 1 je jednorázová investice; kroky 2 a 3 jsou rutina, kterou budete skutečně opakovat.

Cíl

Proměňte „je konec měsíce“ v krátkou, opakovatelnou posloupnost: stáhněte měsíční zaznamenaný čas a transakce ve formátu, který stroj přečte, přetvořte je do shrnutí, jaké potřebujete, a zapište zpět případné opravy – skriptovatelně, aby příští měsíc byl jediný příkaz.

1. Instalace a přihlášení – jednou

Ještě než začnete, zkontrolujte svůj tarif. CLI se ověřuje MCP tokenem a limit MCP tokenů je pod tarifem Pro nulový – na nižších tarifech není co vytvořit, takže je CLI jen pro tarif Pro.

Když je tohle vyřešené: CLI je malý binární program, který nainstalujete z npm:

$ npm install -g @ceum/cli      # installs the `ceum` command (Node.js 22+)

Jde o tentýž token, který pohání MCP integraci. Vytvořte si jej v aplikaci v Nastavení → Integrace a pak se přihlaste:

$ ceum auth login               # paste the token (starts with ceum_)

Přihlášení ověří token proti koncovému bodu a oznámí, kolik nástrojů token dosáhne – nabídka příkazů se odvozuje živě z oprávnění samotného tokenu, takže ceum --help vždy zobrazí přesně ty zdroje a akce, na které dosáhne.

Token se uloží s oprávněními 0600 do vašeho konfiguračního adresáře. U naplánované úlohy, která by se disku neměla dotýkat, jej předejte přes prostředí – ideální pro cron nebo CI:

$ CEUM_TOKEN=ceum_… ceum invoices list

Pokud provozujete více než jeden účet, dejte každému pojmenovaný profil: ceum auth add work, pak ceum --profile work …. Profil je jeden token a koncový bod, proti kterému se ověřuje, takže přepnutí profilu přepne účet, ve kterém pracujete.

2. Stáhněte měsíc dat – ve formátu, který dokážete použít

Každý příkaz pro výpis je řízený zdrojem (ceum <resource> <action>) a přijímá -o pro volbu výstupu. Výchozí text se hezky vysází do tabulky pro čtení; strojové formáty – json, csv, ndjson – jsou bajtově čisté pro předání rourou.

Začněte klíčovým číslem. time-entries aggregate sečte zaznamenaný čas přes sadu filtrů a umí jej seskupit:

$ ceum time-entries aggregate \
    --start-date 2026-07-01 --end-date 2026-07-31 \
    --group-by project -o json

To vrátí celkový počet sekund za měsíc a rozpad podle projektů. Chcete-li stáhnout podkladové řádky do tabulky, vypište je rovnou do CSV – a použijte --all, abyste překonali stránkovací limit na jeden dotaz a spojili všechny stránky:

$ ceum time-entries list --start-date 2026-07-01 --end-date 2026-07-31 \
    --all -o csv > july-time.csv
$ ceum transactions list --all -o csv > july-transactions.csv

Dva drobné zásahy udělají výstup sevřenější: --columns vybere přesně ta pole, která chcete, a uložený preset zachytí sadu filtrů, abyste ji nemuseli psát znovu:

$ ceum transactions list --columns date,desc,amount,type,client
$ ceum presets save transactions month --type expense    # save once
$ ceum transactions list --preset month -o json          # reuse (explicit flags win)

3. Přetvořte to a pak zapište opravy zpět

Protože na stdout jde jen výstup příkazu – výzvy, průběh a chyby jdou všechny na stderr – zůstávají roury čisté. To znamená, že jq a spol. fungují přesně tak, jak byste čekali:

$ ceum invoices list --all -o json | jq -r '.data[] | [.invoiceNumber, .statusConfig.name, .amount] | @tsv'
$ ceum time-entries aggregate --group-by tag -o json \
    | jq -r '.groups[] | [.key, .totalSeconds/3600] | @tsv'

Roura teče oběma směry. Když konec měsíce zahrnuje i zápis dat zpět – třeba zaznamenání dávky výdajů – předejte řádky ze souboru nebo ze stdin příkazu bulk-create; vstup se rozpozná automaticky (pole JSON, jediný objekt, NDJSON nebo CSV) a rozdělí se na dávky podle serverového limitu 50 na dotaz:

$ ceum transactions bulk-create --file july-expenses.ndjson
$ jq -c '.[]' corrections.json | ceum transactions bulk-create --stdin

Teď je z celé věci skript. Návratové kódy kódují třídu selhání (0 ok, 2 použití, 3 ověření, 4 zakázáno, 5 chyba nástroje, 6 síť, 7 konfigurace), takže úloha v cronu pozná síťový výpadek od špatného tokenu a může na to reagovat, místo aby tiše selhala.

Co získáte

Konec měsíce, který je souborem ke spuštění, ne obrazovkou k proklikání: ověřte se jednou, stáhněte měsíc v JSON nebo CSV, přetvořte jej nástroji, které už znáte, a výsledek zapište zpět – tytéž operace, které provádí aplikace, zapojené do vašeho shellu a vašeho plánovače.

Zůstáváte raději v aplikaci, ale chcete si zachovat rychlost ovládání z klávesnice? Příkazová paleta přímo v aplikaci spouští stejnou gramatiku příkazů z panelu uvnitř aplikace.