# OmniSocials CLI and Agent Skills

> Run OmniSocials from Claude Code, Cursor, Windsurf, Codex, Gemini CLI, or GitHub Copilot. One install command gives coding agents a scriptable CLI for posts, media, analytics, the social inbox, and webhooks.

This is the machine-readable version of [omnisocials.com/cli](https://omnisocials.com/cli). Skill discovery: [omnisocials.com/.well-known/agent-skills/index.json](https://omnisocials.com/.well-known/agent-skills/index.json).

## Install

For Claude Code, the MCP server is the recommended path:

```
claude mcp add omnisocials -- npx -y @omnisocials/mcp-server
```

For all skill-compatible agents (Claude Code, OpenClaw, Codex, Cursor, Windsurf, Gemini CLI, GitHub Copilot):

```
npx skills add omnisocials/agent-skills
```

- GitHub repo: [OmniSocials/omnisocials-agent-skills](https://github.com/OmniSocials/omnisocials-agent-skills) (MIT licensed, single file, zero dependencies)
- Raw skill: [SKILL.md](https://raw.githubusercontent.com/OmniSocials/omnisocials-agent-skills/main/skills/omnisocials/SKILL.md)
- Requires Node.js 18+
- Auth: create an API key at [app.omnisocials.com/settings/api](https://app.omnisocials.com/settings/api). Config priority: `OMNISOCIALS_API_KEY` env var, then `./.omnisocials/config.json`, then `~/.config/omnisocials/config.json`. Run `omnisocials.js setup` for interactive setup.

## Command surface

- Setup: `setup`, `config:show`
- Posts: `posts:list`, `posts:get`, `posts:recent-platform`, `posts:create`, `posts:create-and-publish`, `posts:update`, `posts:publish`, `posts:delete`
- Media: `media:list`, `media:upload`, `media:upload-base64`, `media:check`, `media:delete`
- Folders: `folders:list`, `folders:create`
- Hashtag sets: `hashtag-sets:list`, `hashtag-sets:create`, `hashtag-sets:update`, `hashtag-sets:delete`
- Discovery: `locations:search`, `audio:search`
- Accounts: `accounts:list`, `accounts:get`
- Analytics: `analytics:overview`, `analytics:post`, `analytics:posts`, `analytics:accounts`, `analytics:best-times`
- Inbox: `inbox:list`, `inbox:messages`, `inbox:read`, `inbox:reply`
- Webhooks: `webhooks:list`, `webhooks:create`, `webhooks:get`, `webhooks:update`, `webhooks:delete`, `webhooks:rotate-secret`

Global flags: `--json`, `--api-key`, `--base-url`, `--help`.

## Example prompts

- "Post our latest release notes to LinkedIn and X"
- "Show my scheduled posts for this week"
- "Schedule a reel for TikTok tomorrow at 9am"

## Platforms

Instagram, Facebook, LinkedIn (Profile and Page), YouTube, TikTok, X, Pinterest, Threads, Bluesky, Mastodon, and Google Business.

## Pricing

The CLI and agent skills are included in every plan. OmniSocials is $10 per workspace per month billed annually with a 14-day free trial. Details: [omnisocials.com/pricing.md](https://omnisocials.com/pricing.md)

## More

- [llms.txt](https://omnisocials.com/llms.txt)
- [MCP server](https://omnisocials.com/mcp.md)
- [REST API](https://omnisocials.com/api.md)
- [Developer docs](https://docs.omnisocials.com/llms.txt)