Browse docs▾

CLI Package (@auto-social-io/cli)

Command-line tool for managing campaigns, integrations, and publications.

CLI Package (@auto-social-io/cli)

The official auto-social.io CLI package brings agent capabilities directly into your terminal, automation pipelines, and CI workflows.

Installation

Run instantly without global installation:

bash
npx @auto-social-io/cli --help

Or install globally:

bash
npm install -g @auto-social-io/cli

Authentication

Save credentials once on your machine:

bash
auto-social login

If you don't pass an API key, the CLI will offer to open your browser to Account Settings and prompt you to paste your key.

You can also specify the key directly:

bash
auto-social login --key ask_your_api_key

Credentials are saved in ~/.auto-social/config.json.

Commands

Autopilot Campaigns

bash
# List all campaignsauto-social campaigns list
# Filter active campaigns with detailed outputauto-social campaigns list --status active --detailed

Social Integrations

bash
# List all connected social networks and account IDsauto-social integrations --detailed

Publishing Posts

bash
# Queue a post to publish to a specific networkauto-social publish --post-id <POST_UUID> --integration-id <INTEGRATION_UUID>
# Publish to multiple networks with an idempotency keyauto-social publish \  --post-id <POST_UUID> \  --integration-id <FIRST_INTEGRATION_UUID> \  --integration-id <SECOND_INTEGRATION_UUID> \  --idempotency-key <UNIQUE_KEY>