social-agent

social CLI

The CLI exposes social's X and LinkedIn read plane plus current X and LinkedIn write surfaces.

social setup
social setup --scope read,write
social logout
social settings get --json
social usage --json
social x connect
social x accounts list --json
social x accounts use username
social x users me --json
social x tweets get 20 --json
social x tweets list 20 21 --json
social x search recent "from:XDevelopers" --json
social x followers list --json
social x dms list --json
social x dms send-to <user-id> "hello" --dry-run --json
social linkedin connect
social linkedin accounts list --json
social linkedin accounts use public-identifier
social linkedin users me --json
social linkedin users get <identifier> --json
social linkedin users posts <identifier> --json
social linkedin users connections me --json
social linkedin conversations list --json
social linkedin conversations messages <chat-id> --json
social linkedin dms send <chat-id> "hello" --dry-run --json
social linkedin dms start <provider-id> "hello" --dry-run --json
social linkedin invitations send <provider-id> --message "hello" --dry-run --json
social linkedin invitations received --json
social linkedin posts get <postId> --json
social linkedin posts create "hello from social" --dry-run --json
social linkedin search posts "agent tooling" --json
social linkedin companies get <identifier> --json
social linkedin connections list --json
social skill install --target both --json

Use --account username to select a connected X account for a command, and --account public-identifier for LinkedIn. Do not include @ and do not pass raw internal account IDs.

X writes require social setup --scope read,write. Use --dry-run --json before mutating:

social x tweets create "hello from social" --dry-run --json
social x tweets create --body '{"text":"hello from social"}' --dry-run --json
social x tweets delete <tweet-id> --dry-run --json
social x bookmarks add <tweet-id> --dry-run --json
social x bookmarks remove <tweet-id> --dry-run --json
social x likes add <tweet-id> --dry-run --json
social x likes remove <tweet-id> --dry-run --json
social x reposts add <tweet-id> --dry-run --json
social x reposts remove <tweet-id> --dry-run --json
social x follows add <user-id> --dry-run --json
social x follows remove <user-id> --dry-run --json
social x dms list --json
social x dms events <conversation-id> --json
social x dms with <user-id> --json
social x dms send <conversation-id> "hello" --dry-run --json
social x dms send-to <user-id> "hello" --dry-run --json
social x dms start-group <user-id-1,user-id-2> "hello group" --dry-run --json
social x dms delete <event-id> --dry-run --json

LinkedIn/Unipile writes also require social setup --scope read,write. Use provider IDs from profile/conversation reads and dry-run first:

social linkedin invitations send <provider-id> --message "hello" --dry-run --json
social linkedin invitations accept <invitation-id> --shared-secret <secret> --dry-run --json
social linkedin invitations decline <invitation-id> --shared-secret <secret> --dry-run --json
social linkedin invitations cancel <invitation-id> --dry-run --json
social linkedin dms start <provider-id> "hello" --dry-run --json
social linkedin dms start --body '{"attendees_ids":["<provider-id>"],"text":"hello","linkedin":{"api":"classic","inmail":true}}' --dry-run --json
social linkedin dms send <chat-id> "hello" --dry-run --json
social linkedin posts create "hello from social" --dry-run --json
social linkedin posts create --body '{"text":"hello from social","external_link":"https://socialagent.network"}' --dry-run --json
social linkedin posts comment <post-social-id> "sharp take" --dry-run --json
social linkedin posts react <post-social-id> like --dry-run --json
social linkedin conversations mark-read <chat-id> --dry-run --json
social linkedin messages edit <message-id> "updated text" --dry-run --json
social linkedin messages delete <message-id> --dry-run --json
social linkedin messages react <message-id> "like" --dry-run --json
social linkedin messages forward <message-id> <chat-id> --dry-run --json

Regenerate checked-in CLI command artifacts with:

bun run cli:codegen

Build, validate, and pack the publishable CLI package with:

bun run cli:build
bun run cli:package:check
bun run cli:pack