Introduction

For your AI agent to work best with Groniz, install the skill by running:

npx skills add groniz/groniz-cli

Or load the SKILL md file from github.com/groniz/groniz-cli.

The Groniz CLI is a command-line tool for automating social media posting across 32+ platforms. It wraps the Public API so you can schedule posts, manage integrations, and upload media directly from your terminal or shell scripts.

Installation

curl -fsSL https://groniz.com/install.sh | sh

Installs a self-contained native groniz binary — no Node, npm, or pnpm required. It detects your OS/arch, verifies the download’s SHA-256 against the signed manifest, installs to ~/.groniz/bin/groniz, and adds that dir to PATH. Supported: Linux/macOS on x64/arm64 (glibc). Ideal for a fresh box or a coding agent. Verify the installation:

groniz --help

Authentication

Option 1: OAuth2 (Recommended)

Authenticate using the device flow — no client ID or secret needed:

groniz auth login

This will:

Display a one-time code in your terminal
Open your browser to authorize
Automatically save credentials to ~/.groniz/credentials.json

# Check who you're signed in as
groniz whoami

# Remove stored credentials
groniz auth logout

Option 2: API Key

Set your Groniz API key as an environment variable. You can get your API key from the Groniz Settings page.

export GRONIZ_API_KEY=your_api_key_here

Add this to your shell profile (~/.bashrc, ~/.zshrc, etc.) so it persists across sessions.

OAuth2 credentials take priority over the API key when both are present.

Quick Start

# 1. List your connected social media accounts
groniz integrations list

# 2. Create a scheduled post
groniz posts create \
  -c "Hello from the Groniz CLI!" \
  -s "2025-01-15T10:00:00Z" \
  -i "your-integration-id"

# 3. List your scheduled posts
groniz posts list

Commands Overview

Command	Description
`auth login`	Authenticate via OAuth2 device flow
`whoami`	Show who you’re signed in as, and verify the credential
`auth logout`	Remove stored credentials
`integrations list`	List all connected social media accounts
`integrations settings`	Get the settings schema for an integration
`integrations trigger`	Trigger a dynamic tool on an integration
`posts create`	Create a new post
`posts list`	List posts with optional date filtering
`posts delete`	Delete a post by ID
`posts missing`	List available content from provider for a post with missing release ID
`posts connect`	Connect a post to its published content by release ID
`analytics platform`	Get analytics for an integration/channel
`analytics post`	Get analytics for a specific post
`reads x profile`	Read any public X account’s profile
`reads x posts`	Read an X account’s recent posts
`reads x post`	Read a single X post by id
`reads x search`	Search recent X posts by query
`reads x metrics`	Aggregate an X account’s post performance over a window
`upload`	Upload a media file

All commands output JSON, making the CLI easy to use in scripts and automation pipelines.

Getting Started

CLI

MCP

Troubleshooting

Help

Installation

Authentication

Option 1: OAuth2 (Recommended)

Option 2: API Key

Quick Start

Commands Overview

​Installation

​Authentication

​Option 1: OAuth2 (Recommended)

​Option 2: API Key

​Quick Start

​Commands Overview

Installation

Authentication

Option 1: OAuth2 (Recommended)

Option 2: API Key

Quick Start

Commands Overview