Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/groniz/groniz-cli/llms.txt

Use this file to discover all available pages before exploring further.

The Groniz CLI is a self-contained native binary that lets you — and your AI coding agents — schedule social media posts across 32+ channels from the terminal. This skill package teaches agents exactly how to use it correctly, covering the authentication flow, media upload requirements, and per-platform settings discovery that --help alone cannot convey.

Quickstart

From zero to your first scheduled post in under five minutes.

Installation

Install the CLI binary and the agent skill with one command each.

Agent Skills

How to install the skill for Claude Code, Cline, Cursor, and OpenCode.

Command Reference

Full reference for every CLI command, subcommand, and flag.

What the skill teaches agents

The Groniz CLI already documents every flag via groniz --help. This skill covers the four things --help cannot:
1

Authenticate first

Every command fails without credentials. Run groniz auth login to complete the OAuth2 device flow — credentials are saved to ~/.groniz/credentials.json and survive across shells and agent restarts, unlike a bare export GRONIZ_API_KEY which only lasts for the current shell.
2

Upload media before posting

Raw file paths and external URLs are rejected server-side. Run groniz upload <file> first; pass the returned .path value into the post payload.
3

Discover channel settings at runtime

groniz integrations settings <id> is the live source of truth for required fields and character limits. Agents should call this instead of hardcoding platform assumptions that cause 400 errors.
4

Avoid the common traps

The skill documents strict JSON mode shape, differing jq paths, thread chaining via repeated -c, draft behavior that skips validation, and the missing-release-id flow that leaves analytics unavailable.

Supported channels

Groniz posts to 32+ networks, including X, LinkedIn, Instagram, Facebook, Threads, TikTok, YouTube, Reddit, Pinterest, Bluesky, Mastodon, Telegram, Discord, Slack, Medium, Dev.to, Hashnode, WordPress, and more.

Using the CLI

Create, schedule, list, and delete posts from the command line.

Managing Integrations

List connected channels and inspect per-platform settings schemas.

Media Upload

Upload images and video before referencing them in post payloads.

Analytics

Read platform and post-level analytics directly from the CLI.

Build docs developers (and LLMs) love