SmallForce CLI

The smallforce CLI gives you full command-line access to the SmallForce platform — social media publishing, inbox management, CRM, Google reviews, and AI call analytics.

Install

Install globally from npm:

npm install -g smallforce

Verify the installation:

smallforce --version

Authentication

Every command requires a SmallForce API key. To get one, download the SmallForce app → open Settings → create an API key.

Option 1: Environment variable (recommended)

export SMALLFORCE_API_KEY=sf_sk_live_xxx

Add this to your shell profile (.zshrc, .bashrc, etc.) to persist across sessions.

Option 2: CLI flag

Pass the key directly on any command:

smallforce social accounts --api-key sf_sk_live_xxx

The environment variable takes precedence. Use --api-key for one-off commands or scripts that use a different key.

Global options

These options apply to every SmallForce command.

Flag	Description	Default
`--api-key <key>`	SmallForce API key	`SMALLFORCE_API_KEY` env var
`--base-url <url>`	Override the API endpoint	`https://backend.smallforcehq.com`
`--version`	Print CLI version	—
`--help`	Show help for any command	—

Quick start

# List your connected social accounts
smallforce social accounts

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

# List inbox conversations
smallforce inbox conversations

# Check your Google reviews
smallforce reviews list

# View CRM contacts
smallforce contacts list

# List recent calls
smallforce calls list

Command reference

Command group	Description
`social`	Agentic social media — create, schedule, and manage posts across 8 platforms
`inbox`	List conversations, read messages, send replies
`contacts`	CRM with pipeline stages, custom fields, and analytics
`reviews`	Monitor and respond to Google Business reviews
`calls`	AI-powered call transcripts and analysis
`org`	Organization details and configuration

Environment variables

Variable	Description	Default
`SMALLFORCE_API_KEY`	Your API key for authentication	—
`SMALLFORCE_BASE_URL`	Override the backend API URL	`https://backend.smallforcehq.com`