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. Klient příkazové řádky (@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

CLI je malý binární program, který nainstalujete z npm:

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

Ověřuje se pomocí MCP tokenu, téhož tokenu, 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_)
Signed in. 42 tools available under this token.

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

Oddělené pracovní prostory držte odděleně pomocí pojmenovaných profilů (ceum auth add work, pak ceum --profile work …). Nabídka příkazů se odvozuje živě z toho, co váš token umí, takže ceum --help vždy zobrazí přesně ty zdroje a akce, které máte k dispozici.

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ř Ceumu.