SmallForce CLI

AI Workforce for Small Businesses — manage social media, automate DMs, handle reviews, track leads, and analyze calls from the command line.

SmallForce provides AI employees that handle social media management, DM automation, comment automation, review management, and CRM — so small businesses can focus on what matters. This CLI gives you full programmatic access to the platform.

Install

npm install -g smallforce

Quick Start

# Set your API key (get it from the SmallForce app → Settings)
export SMALLFORCE_API_KEY=sf_sk_live_xxx

# List your connected social accounts
smallforce social accounts

# Create and publish a post
smallforce social create --content "Hello world! 🚀" --accounts <account-id> --mode now

# List your inbox conversations
smallforce inbox conversations

# Check your Google reviews
smallforce reviews list

Social Media Management

Create, schedule, and publish posts across Instagram, TikTok, LinkedIn, Facebook, YouTube, X/Twitter, Threads, and Google Business.

| Command | Description | |---------|-------------| | social accounts | List connected accounts with platform-specific field schemas | | social create | Create a post (publish now, schedule, or save as draft) | | social update <id> | Edit a draft or publish it | | social upload <file> | Upload media (image/video) for use in posts | | social posts | List posts with filtering by status, date, and publish mode | | social post <id> | Get full post details including media and analytics |

Two posting modes:

• Simple — --accounts id1,id2 for quick multi-platform posting
• Advanced — --platforms '[...]' with per-platform settings (YouTube titles, Instagram first comments, TikTok privacy, etc.)

Run smallforce social accounts to discover available platform-specific fields for each account.

Supported Platforms

| Platform | Post | Schedule | Draft | Story | First Comment | Media Upload | |----------|------|----------|-------|-------|---------------|-------------| | Instagram | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | TikTok | ✅ | ✅ | ✅ | — | ✅ | ✅ | | LinkedIn | ✅ | ✅ | ✅ | — | ✅ | ✅ | | Facebook | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | YouTube | ✅ | ✅ | ✅ | — | ✅ | ✅ | | X / Twitter | ✅ | ✅ | ✅ | — | — | ✅ | | Threads | ✅ | ✅ | ✅ | — | — | ✅ | | Google Business | ✅ | ✅ | ✅ | — | — | ✅ |

Inbox & DM Automation

Manage WhatsApp and cross-platform conversations.

| Command | Description | |---------|-------------| | inbox conversations | List conversations with filtering by status and platform | | inbox conversation-messages <id> | List messages in a conversation | | inbox send <id> | Send a message to a conversation |

Google Reviews

Monitor and respond to Google Business reviews.

| Command | Description | |---------|-------------| | reviews list | List reviews with filtering by rating and date | | reviews reply <id> | Reply to a review |

CRM & Contacts

Full CRM with sales pipeline and custom fields.

| Command | Description | |---------|-------------| | contacts list | List contacts with search, filtering, and pagination | | contacts get <id> | Get contact details including custom fields | | contacts create | Create a new contact | | contacts update <id> | Update contact details | | contacts move-stage <id> | Move a contact to a pipeline stage | | contacts pipeline | List pipeline stages | | contacts custom-fields | List custom field definitions | | contacts analytics | CRM analytics (totals, pipeline, sources) |

AI Call Analytics

Access AI-powered call analysis and transcripts.

| Command | Description | |---------|-------------| | calls list | List calls with date filtering and pagination | | calls get <id> | Full call details with transcript and AI analysis |

Authentication

# Environment variable (recommended)
export SMALLFORCE_API_KEY=sf_sk_live_xxx

# Or use a CLI flag
smallforce social accounts --api-key sf_sk_live_xxx

To get your API key:

1. Download the SmallForce app from the App Store or visit smallforcehq.com/download
2. Open the app → go to Settings
3. Create an API key

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | SMALLFORCE_API_KEY | API key for authentication | — | | SMALLFORCE_BASE_URL | Override API URL | https://backend.smallforcehq.com |

Links

• 🌐 SmallForce
• 📖 Documentation
• 📱 Download App

License

MIT