CLI quickstart

Install social0, log in with an API key, list accounts, and publish your first post.

1. Prerequisites

Install Node.js 20+.
Connect at least one platform in Dashboard → Connections.
Create an API key (sk_live_…) in Dashboard → API keys.

2. Install and log in

npm install -g social0
social0 login          # paste sk_live_… (masked)
social0 whoami

Or pipe the key:

echo "sk_live_..." | social0 login

For CI / non-interactive:

export SOCIAL0_API_KEY=sk_live_...
social0 accounts --json

3. List accounts

social0 accounts

You’ll see numeric IDs (1, 2, 3…) plus platform names. Use IDs when you have more than one account on the same platform.

4. Publish once

social0 publish --content "Hello from the CLI" --platform twitter linkedin

Short form:

social0 publish -c "Hello from the CLI" -p twitter linkedin

5. Check health

social0 doctor

Recipes

First publish

social0 accounts
social0 publish -c "Ship day" -p twitter linkedin

Upload then publish

social0 upload ./hero.png --json   # copy media id
social0 publish -c "New look" -p instagram -m <media-uuid>

Schedule

social0 schedule -c "Tomorrow launch" -p 1 2 -t "tomorrow 9am"

Natural times that work: tomorrow 9am, today 8pm, next monday, 2026-08-01 14:00, in 2 hours, in 2 days at 3pm. Times use your local wall-clock — set a default with social0 config set defaultTimezone … if needed.

Draft workflow

social0 post create -c "WIP" -p linkedin
social0 drafts
social0 drafts publish <full-uuid>

Markdown with front matter

---
platforms:
  - twitter
  - linkedin
schedule: tomorrow 9am
---

Launching Social0 today

social0 publish launch.md

JSON / automation

social0 accounts --json
social0 post list --status draft --json

Core ideas

Concept	What to remember
Account aliases	Platform name (`twitter`) or numeric ID from `social0 accounts`
Drafts	`post create` → draft; `post create --publish` → publish now
Publish	`publish` accepts content flags, draft id, `latest`, `.md`, or stdin
Status	After publish, `social0 status <tracking-id>` (add `--watch` to poll)

Troubleshooting

Problem	Fix
`Not authenticated`	Run `social0 login` or set `SOCIAL0_API_KEY`
Invalid key	Key must start with `sk_live_…` from API keys
No connected accounts	Connect platforms in the dashboard first
Ambiguous platform	Use the numeric account ID from `social0 accounts`
Short IDs fail on show/edit	Use the full UUID
HTTP 429	CLI retries automatically; wait or upgrade plan
Auth / API looks broken	Run `social0 doctor`
Self-hosted API	Pass `--api-url` or set `SOCIAL0_API_URL` — see Commands

Commands reference
REST API for raw HTTP
MCP if you prefer an AI assistant