Commands

Full command reference for the Social0 CLI — auth, accounts, posts, publish, schedule, and ops.

Global package: social0 (v0.1.2). Thin client over https://api.social0.app/v1.

Global flags

Available on every command:

Flag	Meaning
`--json`	JSON output
`--yaml`	YAML output
`--table`	Table output (default)
`--verbose`	Verbose request logging (sensitive URLs redacted where needed)
`--api-url <url>`	Override API base for this run

Auth

social0 login
social0 login --skip-passphrase
social0 login --require-passphrase
echo "sk_live_..." | social0 login

social0 logout
social0 whoami
social0 passphrase status
social0 passphrase set
social0 passphrase remove

whoami shows name, email, plan, API URL, and a masked key (GET /v1/me).

Keys must start with sk_live_…. Create them in Developer settings.

Credential storage

Prefer OS keychain (macOS Keychain / Linux Secret Service / Windows Credential Manager)
Fallback: ~/.social0/ file with mode 0600
Optional AES passphrase for file fallback: --skip-passphrase, --require-passphrase, or SOCIAL0_CREDENTIAL_PASSPHRASE
Env auth: SOCIAL0_API_KEY is used as-is and not written to disk

Config

social0 config
social0 config list
social0 config get <key>
social0 config set <key> <value>

Key	Purpose
`apiUrl`	API base URL
`defaultWorkspace`	Default workspace
`defaultTimezone`	Timezone for natural schedule times
`defaultPlatform`	Default platform alias
`outputFormat`	Default output (`table`, `json`, `yaml`)

Config file: ~/.social0/config.json.

Accounts

social0 accounts
social0 accounts connect <platform>    # opens dashboard connect guidance
social0 accounts disconnect <id>

Pass platforms as names (twitter, linkedin, instagram, …) or numeric IDs from social0 accounts. Prefer IDs when multiple accounts share a platform.

Posts

social0 post create -c "Hello" -p twitter linkedin
social0 post create -c "Hello" -p 1 2 --publish
social0 post create -c "Later" -p linkedin -s "tomorrow 9am"

social0 post list
social0 post list --status draft
social0 post show <id>
social0 post edit <id> -c "Updated"
social0 post delete <id>
social0 post init          # sample JSON template

Default post create saves a draft. Add --publish to publish immediately, or -s / --schedule for a time.

Publish / schedule / media / status

social0 publish -c "Ship day" -p twitter linkedin
social0 publish <draft-id>
social0 publish latest
social0 publish post.md
echo "From stdin" | social0 publish -p twitter

social0 schedule -c "Tomorrow launch" -p 1 2 -t "tomorrow 9am"
social0 schedule post.md
social0 schedule batch.json

social0 upload ./hero.png ./clip.mp4
social0 upload ./hero.png --json

social0 status <tracking-id>
social0 status <tracking-id> --watch

publish / schedule targets can be content flags, a draft id, latest, a .md file (supports front matter), or stdin. Schedule also accepts a JSON batch file.

Drafts

social0 drafts
social0 drafts list
social0 drafts publish <id>
social0 drafts schedule <id> -t "tomorrow 9am"
social0 drafts delete <id>

Prefer the full UUID for draft publish/schedule/delete when short IDs fail.

Project / ops

social0                 # interactive menu
social0 examples
social0 link -p twitter linkedin
social0 link -f json    # writes .social0 in the current directory

social0 watch           # monitor publish queue
social0 logs            # stream publish events
social0 export out.json
social0 import in.json

social0 completion bash
social0 completion zsh
social0 completion fish
social0 completion powershell

social0 doctor
social0 version
social0 update

Custom API URL

Priority (highest first):

--api-url <url>
SOCIAL0_API_URL
social0 config set apiUrl … (~/.social0/config.json)
Default https://api.social0.app/v1

The CLI appends /v1 if you omit it.

social0 --api-url https://api.social0.app accounts
export SOCIAL0_API_URL=https://api.social0.app/v1
social0 config set apiUrl https://api.social0.app/v1
social0 config get apiUrl

Environment variables

Variable	Purpose	Default
`SOCIAL0_API_KEY`	API key for CI / headless	—
`SOCIAL0_CREDENTIAL_PASSPHRASE`	Encrypt local fallback credentials	—
`SOCIAL0_API_URL`	API base	`https://api.social0.app/v1`
`SOCIAL0_REQUEST_TIMEOUT_MS`	Request timeout	`30000`
`SOCIAL0_MAX_RETRIES`	Retries on HTTP 429	`3`
`SOCIAL0_VERBOSE`	Verbose logs (`1` to enable)	`0`

Coming soon

These commands exist in the CLI but are not ready yet — don’t rely on them:

social0 suggest
social0 improve
social0 hashtags

On this page