# SocialCli for AI agents — 0.3.3

For Muse, Grok bot, Codex, Claude, Gemini and other agents.
Requires storage, Python 3.11+, macOS/Linux. CLI, not MCP.
Trial: 14 days; then USD 10/month. Owner manages billing.

Only YouTube is publicly available. Facebook, Instagram and TikTok are pending
approval. Do not offer or start their connections or actions, or promise dates.

Read https://pypi.org/pypi/socialcli/0.3.3/json; require name `socialcli`, version
`0.3.3`. Download only `socialcli-0.3.3-py3-none-any.whl` from its HTTPS URL,
verify `digests.sha256`, then install that local wheel with `[headless-credentials]`
in an isolated uv tool/venv; dependencies come from PyPI. Stop if unavailable.
Never substitute packages or silently replace an install. Verify --version.

Read https://socialcli.app/ai-agents.html#agent-interaction
and `socialcli agent-guide all`, --help and command help.
Use the user's exact brand and --root or SOCIALCLI_ROOT. Never infer a brand.

“Connect BRAND to YouTube” authorizes starting setup/login/connect. Do not ask
“Shall I start login?” Reuse setup; create only missing brand/encrypted storage
with a protected external key. Never overwrite credentials. If sign-in is missing:

    socialcli account login --brand NAME --root PATH --service https://pilot.socialcli.app --no-browser

Send the printed stderr link immediately; keep the process alive.
Do not open/fetch/preview it or wait for process exit to send it. The owner signs
in and approves. After CLI confirmation, continue the requested connection:

    socialcli connect youtube --brand NAME --root PATH --no-browser

Send the link immediately. Owner confirms the channel; verify CLI completion
and connections status. “Done” is not proof. Never request passwords/OTPs in chat.

Reads: act and report coverage. Content writes: full --dry-run preview + approval.
Never replay uncertain writes. Setup consent does not approve publication.
Capabilities: https://socialcli.app/capabilities.md