AI Agents CLI

Shell CLI for Claude Code, OpenClaw, and automation — JSON in, JSON out.

The socioi CLI wraps the Public API for AI agents that run shell commands (Claude Code, OpenClaw, scripts). Every command prints JSON on stdout.

Use…	When…
MCP	Claude.ai, ChatGPT, or Cursor speak Model Context Protocol
AI Agents CLI (this page)	The agent runs terminal commands / skills

Same si_live_… API key as the Public API and Cursor MCP.

Install

The CLI package is @socioi/cli (binary socioi). It is not on the public npm registry yet — install from the Socioi repo:

pnpm install
pnpm --filter @socioi/cli build
pnpm --filter @socioi/cli exec npm link
socioi --help

When published to npm you will be able to run npm i -g @socioi/cli or npx @socioi/cli.

Auth

export SOCIOI_API_KEY=si_live_YOUR_KEY
# optional — default https://socioi.com/api
export SOCIOI_API_URL=https://socioi.com/api

Create a key in Settings → Developers → Access.

You can also pass --api-key and --api-url per command.

Quick start

socioi whoami
socioi channels list
socioi media upload ./photo.jpg
socioi posts create -c "Hello from Socioi Agent" -i "CHANNEL_ID" -m "MEDIA_ID" --type now

Commands

Command	Description
`socioi whoami`	Validate key; return org / user ids
`socioi channels list`	Connected channels
`socioi channels quota`	Plan channel quota
`socioi posts list [--status]`	List posts
`socioi posts get <id>`	Get one post
`socioi posts create`	Create draft / schedule / now (`-c`, `-i`, `-m`, `-s`, `--type`)
`socioi posts schedule <id> -s <ISO>`	Schedule an existing post
`socioi posts delete <id>`	Delete a post
`socioi media list`	List media
`socioi media upload <file\|url>`	Upload local file or import URL
`socioi media delete <id>`	Delete media

Agent skill

The package ships with SKILL.md for OpenClaw / Claude Code (required env SOCIOI_API_KEY, binary socioi).

Errors

Failures print JSON like { "ok": false, "error": "…", "status": 401 } and exit non-zero so agents can branch on status.