Repolode
Submit
gitroomhq

gitroomhq/postiz-agent

A command-line interface for the Postiz API that lets AI agents and developers schedule and manage social media posts across many platforms.

Open-source alternative to:HootsuiteBuffer

View on GitHubWebsite
Stars
530
Forks
112
Open issues
17
Last commit
yesterday

What is it?

Postiz CLI is a command-line client for the Postiz social media scheduling API. It lets developers and AI agents list connected channels, create scheduled, draft or multi-platform posts, attach media, and pull analytics, with every command printing JSON for easy parsing in scripts.

The CLI covers platform-specific needs such as Reddit flairs, YouTube playlists, LinkedIn company pages, TikTok privacy settings and Instagram stories, using a discovery workflow where agents query each integration's settings and tools before posting. Media must be uploaded through the CLI first so platforms like TikTok, Instagram and YouTube accept the URLs, and an optional adjust step resizes or re-encodes files to platform limits.

The repository also packages the same capabilities as skills and plugins for Claude Code, Cursor, Gemini CLI, Grok Build, Qwen Code and DeepSeek Harness, and includes a clipping feature that turns long YouTube videos into captioned vertical clips.

Key features

  • 01Schedule, draft, or publish posts to multiple social platforms in one command
  • 02Upload media and reuse files from the media library, with optional resizing for platform limits
  • 03Supports comment threads, with each comment carrying its own media
  • 04Fetch platform-specific data such as Reddit flairs and YouTube playlists
  • 05Retrieve platform and post analytics
  • 06Clip long YouTube videos into short vertical clips with captions

Use cases

  • Letting an AI agent such as Claude Code schedule posts across channels
  • Batch-scheduling a content calendar from a script or JSON file
  • Cross-posting the same announcement to Twitter/X, LinkedIn and Facebook
  • Turning a long YouTube video into short clips for TikTok or Instagram

Quick start

  1. 1

    Install the Postiz CLI from npm

    npm install -g postiz
  2. 2

    Authenticate with the OAuth2 device flow

    postiz auth:login
  3. 3

    List your connected integrations to get their IDs

    postiz integrations:list

Things to know

  • The license is not clearly specified in the project metadata.
  • Posting requires a Postiz account with connected social media channels and an API key or OAuth login.
  • Authentication by default uses the hosted auth server at cli-auth.postiz.com.

Topics

#social-media#ai-agents#cli#scheduling#automation#claude-code#agent-skills#agentic-ai#agents#claude

FAQ

What is postiz-agent?
A command-line interface for the Postiz API that lets AI agents and developers schedule and manage social media posts across many platforms. Postiz CLI is a command-line client for the Postiz social media scheduling API. It lets developers and AI agents list connected channels, create scheduled, draft or multi-platform posts, attach media, and pull analytics, with every command printing JSON for easy parsing in scripts.
Is postiz-agent free to use? What license does it have?
postiz-agent is open source under the Other license. Check the license terms before using it in commercial products.
Is postiz-agent still maintained?
Actively maintained. The last commit to postiz-agent was on Oct 20, 2026.
What can I use postiz-agent for?
Letting an AI agent such as Claude Code schedule posts across channels Batch-scheduling a content calendar from a script or JSON file Cross-posting the same announcement to Twitter/X, LinkedIn and Facebook Turning a long YouTube video into short clips for TikTok or Instagram
How do I install postiz-agent?
Install the Postiz CLI from npm: npm install -g postiz Authenticate with the OAuth2 device flow: postiz auth:login List your connected integrations to get their IDs: postiz integrations:list
Where can I get postiz-agent?
The source code and installation instructions are on GitHub: https://github.com/gitroomhq/postiz-agent

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects