There are two things you may want to install: the Groniz CLI binary, which is the tool you run in your terminal or scripts, and theDocumentation 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.
groniz/groniz-cli agent skill, which teaches AI coding agents how to drive the CLI correctly. Most developers install both. The CLI is required; the skill is only needed if you plan to let an agent (Claude Code, Cursor, etc.) call Groniz commands on your behalf.
CLI Installation
One-line install
- Detects your operating system and CPU architecture.
- Downloads the appropriate pre-built native binary.
- Verifies the download against its SHA-256 checksum.
- Installs the binary to
~/.groniz/bin/groniz. - Adds
~/.groniz/binto your shellPATH(writes to your shell profile if needed).
The Groniz CLI is a self-contained native binary. It does not require Node.js, npm, Python, or any other runtime. The only prerequisite is
curl — which is pre-installed on all supported platforms.Supported platforms
| OS | Architecture |
|---|---|
| Linux | x64 (glibc) |
| Linux | arm64 (glibc) |
| macOS | x64 (Intel) |
| macOS | arm64 (Apple Silicon) |
Verify the installation
After the installer completes, open a new terminal (or source your profile) and run:~/.groniz/bin to your PATH manually:
~/.bashrc, ~/.zshrc, or equivalent shell profile to make it permanent.
Updating the CLI
To update to the latest version:groniz update --check exits with code 10 when a newer version is available and code 0 when you are already on the latest. This makes it suitable for use in CI scripts and pre-flight checks.
Agent Skill Installation
Thegroniz/groniz-cli skill is a short, structured prompt file that tells supported AI coding agents how to use the Groniz CLI correctly — covering authentication, media uploads, runtime settings discovery, and common failure traps that groniz --help does not address.
Auto-detect your agent
Run the following command from your project root. It inspects your project structure and installs the skill into the appropriate directory for each detected agent:Target specific agents
To skip the detection prompt and install for specific agents only:claude-code, cline, cursor, opencode.
Install locations
| Agent | Skill location |
|---|---|
| Claude Code | .claude/skills/ |
| Cline | .agents/skills/ |
| Cursor | .agents/skills/ |
| OpenCode | .agents/skills/ |
What the skill teaches
Once installed, the skill instructs your agent to:- Authenticate before running any other command (stored credentials survive across sessions;
exportstatements do not). - Call
groniz uploadand capture the returned.pathbefore attaching media to a post. - Call
groniz integrations settings <id>to discover per-channel character limits and required fields at runtime, rather than assuming platform defaults. - Avoid the common failure patterns: wrong JSON output shape, differing
jqpaths, thread syntax, draft-mode validation skipping, and the missing-release-id analytics gap.
npx requires Node.js to run the skills installer. This is a one-time setup step — the CLI itself does not need Node.js at runtime.Requirements summary
| Component | Requirement |
|---|---|
| Groniz CLI | curl (pre-installed on all supported platforms) |
| Agent skill | npx / Node.js (install only) |
| Runtime | None — CLI is a self-contained binary |