Příkazový řádek (CLI)

posty-cli: nástroj pro příkazový řádek

Instalace, formát výstupu, práce s daty a k čemu je plánovači dobrý nástroj pro příkazový řádek.

Instalace

Balíček
posty-cli
Příkaz
posty
Instalace
npm install -g posty-cli
Dostupnost
K dispozici od tarifu Pro. Platí stejná oprávnění jako pro API. Viz stránku Tarify.
npm install -g posty-cli
posty --version
posty --help

První příkazy

posty auth:login          # přihlášení v prohlížeči
posty auth:status         # ke kterému pracovnímu prostoru je počítač připojený
posty integrations:list   # připojené kanály s ID

Ostatní příkazy očekávají identifikátor kanálu právě pod tímto názvem. Jednou si ho vypište a uložte.

Pravidla pro výstup

JSON na standardní výstup, vše ostatní na chybový výstup

Výsledný JSON se zapisuje na standardní výstup, stavové zprávy a chyby na chybový výstup. Při neúspěšném běhu příkaz skončí s nenulovým návratovým kódem. Výstup tak můžete bezpečně předat dalším příkazům a volající program pozná, co se stalo.

# jen ID kanálů
posty integrations:list | jq -r '.[].id'

# při plánovaném běhu jdou chyby do logu a JSON ke zpracování
posty posts:list --startDate ... --endDate ... > kalendar.json 2>> chyby.log

Datum a časová pásma

Datum vždy zadejte jednoznačně. Jsou dvě platné podoby:

  • ISO 8601 s uvedeným časovým posunem: 2026-12-31T12:00:00Z nebo 2026-12-31T12:00:00+01:00.
  • Datum a čas bez posunu, se zadaným časovým pásmem: "2026-12-31 12:00" s přepínačem --timezone Europe/Budapest.
Chyba místo odhadu

Když zadáte datum a čas bez posunu a časové pásmo není ani v přepínači, ani v proměnné POSTY_TIMEZONE, ani v nastavení posty config:set timezone, příkaz skončí chybou. Je to záměr. Příspěvek potichu naplánovaný na nesprávný čas je mnohem horší než chybová zpráva.

posty config:set timezone Europe/Budapest
posty config:get timezone

Pro agenty

Balíček obsahuje soubor SKILL.md, který popisuje všechny příkazy a přepínače. Agent s přístupem k terminálu se z něj naučí nástroj používat bez pročítání webu.

Pokud váš agent nepoužívá shell a chce se připojit přímo, použijte raději MCP server.

Příkazy

Něco vám na této stránce chybí? Napište na [email protected] nebo na stránce Nápověda vyplňte formulář.