Skip to main content
Connect social accounts, then draft, schedule, publish and analyze posts from the CLI. All commands return the standard JSON envelope (success, action, result, next_steps, hints).

Commands

Connecting accounts

connect requires --platform (TWITTER, LINKEDIN, INSTAGRAM, FACEBOOK, TIKTOK, YOUTUBE, THREADS, PINTEREST, REDDIT, BLUESKY); both connect and portal accept --redirect-url <url> (default: https://dashboard.usenaive.ai). The result contains the URL to open; after connecting, run naive social sync. Use naive social label <account-id> --label "Company Brand" to distinguish multiple accounts on the same platform, and naive social disconnect <account-id> to remove one.

Creating posts

Posts are created as drafts by default. Pass --publish to publish immediately, or --schedule-at to schedule.
Example output (with --publish):
Media can also be uploaded ahead of time from a public URL:

Managing posts

Analytics

For a post that has not been posted yet, analytics is null and comments is [], each with a hint explaining why.

Platform tips

Credits

Publishing costs 2.5 credits per post (+0.5 if the post targets X, +5 if that X post carries a link — X passes its own API charge through), deducted at publish time. Drafts and every other command are free. Audit deductions with naive usage.