---
title: "posty-cli: a parancssori eszköz | Posty dokumentáció"
description: "Telepítés, a kimeneti szerződés, a dátumkezelés, és mire jó egy parancssori eszköz egy ütemezőhöz."
canonical: https://posty.hu/en/docs/cli
source: https://posty.hu/en/docs/cli.md
---

Parancssor (CLI)

# posty-cli: a parancssori eszköz

Telepítés, a kimeneti szerződés, a dátumkezelés, és mire jó egy parancssori eszköz egy ütemezőhöz.

## Installation

Package

`posty-cli`

Command

`posty`

Install

`npm install -g posty-cli`

Availability

Available on the Pro plan and above, with the same permissions as the API. See the [Plans](https://posty.hu/en/docs/plans) page.

```
npm install -g posty-cli
posty --version
posty --help
```

Kód másolása

## First commands

```
posty auth:login          # böngészős bejelentkezés
posty auth:status         # melyik munkaterülethez van kötve a gép
posty integrations:list   # a bekötött csatornák, azonosítóval
```

Kód másolása

All other commands expect this value as the channel ID. List it once and save it.

## The output contract

JSON on stdout, everything else on stderr

Results go to stdout as JSON. Status messages and errors go to stderr. On failure, the command exits non-zero. That's what makes the output safe to pipe to other commands, and lets the caller know what happened.

```
# csak a csatornaazonosítók
posty integrations:list | jq -r '.[].id'

# ütemezett futásban a hibák a naplóba mennek, a JSON a feldolgozónak
posty posts:list --startDate ... --endDate ... > naptar.json 2>> hiba.log
```

Kód másolása

## Dates and time zones

Always provide an unambiguous date. There are two valid ways to specify it:

- **ISO 8601 with an explicit offset:** `2026-12-31T12:00:00Z` or `2026-12-31T12:00:00+01:00`.
- **A time without an offset and a specified time zone:** `"2026-12-31 12:00"` with the `--timezone Europe/Budapest` flag.

An error instead of guesswork

If you provide a date without an offset and don't set a time zone using the flag, the `POSTY_TIMEZONE` variable, or `posty config:set timezone`, the command exits with an error. That's intentional. A post scheduled for the wrong time without warning is much worse than an error message.

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

Kód másolása

## For agents

The package includes a `SKILL.md` file that describes every command and flag. An agent with terminal access can learn to use the CLI from that file, without reading a website.

If your agent connects directly instead of working through a shell, use the [MCP server](https://posty.hu/en/docs/mcp) instead.

## Commands

[Authentication — auth:login, auth:status, auth:logout, API key via an environment variable.](https://posty.hu/en/docs/cli/authentication)[Posts — posts:create, posts:list, posts:status, posts:delete, find-slot.](https://posty.hu/en/docs/cli/posts)[Channels — integrations:list, settings, trigger, groups.](https://posty.hu/en/docs/cli/channels)[Analytics — analytics:platform, analytics:post, posts:missing.](https://posty.hu/en/docs/cli/analytics)[Media upload — upload and how to add the file to a post.](https://posty.hu/en/docs/cli/upload)[Platform examples — Ready-to-use commands for X, YouTube, TikTok, and multi-channel posts.](https://posty.hu/en/docs/cli/examples)

Documentation pages

Is something missing from this page? Email [norbert@posty.hu](mailto:norbert@posty.hu) or use the form on the [Help](https://posty.hu/en/help) page.