<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> Postiz Agents CLI is a command-line tool designed for AI agents and developers to automate social media posting across over 28 platforms. It enables programmatic scheduling, content management, and media handling, simplifying cross-platform social media workflows and enhancing AI-driven content distribution.

How It Works

The CLI interacts with the Postiz API, allowing users to authenticate via OAuth2 or API keys. It supports dynamic discovery of platform-specific features, enabling AI agents to adapt to different social networks by querying available settings and tools. Core functionalities include creating, managing, and analyzing posts, with a mandatory media upload step for certain platforms to ensure reliable delivery of content.

Quick Start & Requirements

• Installation: npm install -g postiz or pnpm install -g postiz.
• Prerequisites: Node.js, npm/pnpm.
• Authentication: Recommended: postiz auth:login (OAuth2 device flow). Alternative: export POSTIZ_API_KEY=your_api_key_here.
• Setup: Authentication is required before using most commands.

Highlighted Details

• Multi-Platform Support: Automates posting to 28+ platforms including X, LinkedIn, Reddit, YouTube, TikTok, and Instagram.
• AI Agent Integration: Features dynamic discovery of integration capabilities (settings, tools) for seamless AI agent adaptation.
• Media Handling: Requires pre-uploading media via postiz upload for platforms like TikTok, Instagram, and YouTube to ensure trusted URLs.
• JSON Output & Mode: All CLI commands output JSON for easy parsing, and a --json flag allows complex post structures to be defined in files.
• Threading: Supports creating multi-part posts (threads, comments) that are adapted to platform conventions.

Maintenance & Community

The README does not provide specific details on notable contributors, sponsorships, or community channels like Discord/Slack.

Licensing & Compatibility

• License: AGPL-3.0.
• Compatibility: The AGPL-3.0 license may impose copyleft restrictions, requiring derivative works to also be open-sourced under AGPL-3.0. Compatibility with closed-source applications should be carefully reviewed.

Limitations & Caveats

Media files must be uploaded to Postiz before being referenced in posts, adding an extra step for platforms requiring verified URLs. Post analytics can be challenging if platforms do not return a usable post ID, requiring manual resolution via posts:missing and posts:connect commands.