Postiz

{
  "name": "postiz-agent",
  "owner": {
    "name": "Nevo David",
    "email": "nevo@postiz.com"
  },
  "metadata": {
    "description": "Postiz social media automation skill for scheduling posts across 28+ platforms",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "postiz",
      "description": "Social media automation CLI for scheduling posts, managing integrations, uploading media, and tracking analytics across 28+ platforms including X, LinkedIn, Reddit, YouTube, TikTok, Instagram, and more",
      "source": "./",
      "strict": false,
      "skills": [
        "./"
      ]
    }
  ]
}


{
  "name": "postiz",
  "version": "2.0.12",
  "description": "Social media automation CLI for scheduling posts, managing integrations, uploading media, and tracking analytics across 28+ platforms including X, LinkedIn, Reddit, YouTube, TikTok, Instagram, and more",
  "author": {
    "name": "Nevo David",
    "email": "nevo@postiz.com",
    "url": "https://github.com/nevo-david"
  },
  "homepage": "https://docs.postiz.com/public-api/introduction",
  "repository": "https://github.com/gitroomhq/postiz-agent",
  "license": "AGPL-3.0",
  "skills": ["./"],
  "keywords": [
    "postiz",
    "social-media",
    "scheduling",
    "automation",
    "ai-agent",
    "twitter",
    "linkedin",
    "facebook",
    "instagram",
    "tiktok",
    "youtube",
    "reddit"
  ]
}


# Changelog

All notable changes to the Postiz CLI will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.0] - 2026-02-13

### Added
- Initial release of Postiz CLI
- `posts:create` - Create new social media posts
- `posts:list` - List all posts with pagination and search
- `posts:delete` - Delete posts by ID
- `integrations:list` - List connected social media integrations
- `upload` - Upload media files (images)
- Environment variable configuration (POSTIZ_API_KEY, POSTIZ_API_URL)
- Comprehensive help documentation
- Example scripts for basic usage and AI agent integration
- SKILL.md for AI agent usage patterns

### Features
- Command-line interface for Postiz API
- Support for scheduled posts
- Multi-platform posting via integrations
- Media upload functionality
- User-friendly error messages with emojis
- JSON output for programmatic parsing
- Comprehensive examples for AI agents


# Dependencies
node_modules/
/pnpm-lock.yaml
/package-lock.json
/yarn.lock

# Build output
dist/
*.tsbuildinfo

# Environment
.env
.env.local
.env.*.local

# IDE
.vscode/
.idea/
*.swp
*.swo
*~
.DS_Store

# Logs
logs/
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*

# Testing
coverage/
.nyc_output/

# Temporary files
*.tmp
*.temp


# Integration Settings Discovery

The CLI now has a powerful feature to discover what settings are available for each integration!

## New Command: `integrations:settings`

Get the settings schema, validation rules, and maximum character limits for any integration.

## Usage

```bash
postiz integrations:settings <integration-id>
```

## What It Returns

```json
{
  "output": {
    "maxLength": 280,
    "settings": {
      "properties": {
        "who_can_reply_post": {
          "enum": ["everyone", "following", "mentionedUsers", "subscribers", "verified"],
          "description": "Who can reply to this post"
        },
        "community": {
          "pattern": "^(https://x.com/i/communities/\\d+)?$",
          "description": "X community URL"
        }
      },
      "required": ["who_can_reply_post"]
    }
  }
}
```

## Workflow

### 1. List Your Integrations

```bash
postiz integrations:list
```

Output:
```json
[
  {
    "id": "reddit-abc123",
    "name": "My Reddit Account",
    "identifier": "reddit",
    "provider": "reddit"
  },
  {
    "id": "youtube-def456",
    "name": "My YouTube Channel",
    "identifier": "youtube",
    "provider": "youtube"
  },
  {
    "id": "twi