# Postiz

Postiz is a tool to schedule social media and chat posts to 28+ channels X, LinkedIn...

- Repository: https://github.com/gitroomhq/postiz-agent (562 stars)
- Category: Marketing
- License: see repository
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add gitroomhq/postiz-agent --skill postiz -g -a claude-code -y`
Codex: `npx skills add gitroomhq/postiz-agent --skill postiz -g -a codex -y`
Cursor: `npx skills add gitroomhq/postiz-agent --skill postiz -g -a cursor -y`
Gemini CLI: `npx skills add gitroomhq/postiz-agent --skill postiz -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add gitroomhq/postiz-agent`

## Description

Postiz is a tool to schedule social media and chat posts to 28+ channels X, LinkedIn, LinkedIn Page, Reddit, Instagram, Facebook Page, Threads, YouTube, Google My Business, TikTok, Pinterest, Dribbble, Discord, Slack, Kick, Twitch, Mastodon, Bluesky, Lemmy, Farcaster, Telegram, Nostr, VK, Medium, Dev.to, Hashnode, WordPress, ListMonk

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Install Postiz if it doesn't exist

```bash
npm install -g postiz
# or
pnpm install -g postiz
```

npm release: https://www.npmjs.com/package/postiz
postiz github: https://github.com/gitroomhq/postiz-app
postiz cli github: https://github.com/gitroomhq/postiz-app
official website: https://postiz.com
---


| Property | Value |
|----------|-------|
| **name** | postiz |
| **description** | Social media automation CLI and MCP server for scheduling posts across 28+ platforms including X, LinkedIn, LinkedIn Pages, Instagram, Facebook, Threads, YouTube, TikTok, Reddit, Pinterest, Bluesky, Mastodon, Google My Business, Discord, Slack, Telegram, Twitch, Kick, Lemmy, Farcaster, Nostr, VK, MeWe, Tumblr, Skool, Whop, Moltbook, Dribbble, Medium, Dev.to, Hashnode, WordPress, and ListMonk |
| **allowed-tools** | Bash(postiz:*) |

---

## ⚠️ Four Hard Rules (Read First)

**Rule 1, Authenticate before anything.** All commands fail without valid credentials.

**Rule 2, Every file passed to `-m` (or to `image`/media fields in JSON mode) MUST first go through `postiz upload`.** Raw filesystem paths (`image.jpg`, `video.mp4`) and external URLs (`https://example.com/...`) are **NOT** accepted by the publishing pipeline. TikTok, Instagram, YouTube, and most other providers reject anything that isn't a Postiz-verified URL. Always:

```bash
RESULT=$(postiz upload <file>)
URL=$(echo "$RESULT" | jq -r '.path')
postiz posts:create ... -m "$URL" ...
```

If you see `-m "something.jpg"` anywhere below, treat it as shorthand for "the `.path` you got back from `postiz upload something.jpg`", never a raw local file.

A file that was already uploaded does not need uploading again: find it with `postiz media:list -s <name>` and reuse its `.path`.

The rest: https://github.com/gitroomhq/postiz-agent/blob/HEAD//SKILL.md