Xpert CLI

Manage your Xpert X-growth workspace from the terminal.

npx @xpertso/cli login        # or: npm i -g @xpertso/cli

Sign in

xpert login

Press Enter — your browser opens to xpert.so, you click Authorize (it reuses your existing Xpert session), and the CLI stores a scoped API key locally (~/.config/xpert/config.json). xpert logout removes it.

Use it

xpert whoami
xpert run list-drafts --limit 10
xpert run create-draft --kind post --content '[{"text":"gm"}]'
xpert run compose-post --prompt "a punchy hook about shipping"
xpert run schedule-post --draft-id <id> --use-best-time true
xpert run analytics-overview

Every Xpert API endpoint is available as xpert run <name> (see xpert run --help). For anything not yet wrapped — including new endpoints — use the generic escape hatch:

xpert api GET /v1/posts --query per_page=5
xpert api POST /v1/drafts --data '{"kind":"post","content":[{"text":"hi"}]}'

Add --json for raw output, --account <id> to act as a specific connected X account.

Config

| Env var | Default | | --- | --- | | XPERT_API_URL | https://api.xpert.so | | XPERT_MCP_URL | https://mcp.xpert.so | | XPERT_CONFIG_DIR | ~/.config/xpert |