Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Quickstart

Three steps: log in, connect an account, post.

1. Install and log in

npm install -g akarso
akarso auth login
This opens your browser, signs you in with Google, and saves an API key automatically. No manual key setup needed — see Authentication for CI and env var options.
Verify it works:
akarso auth check

2. Connect a social account

Connect your first platform. The CLI opens your browser for OAuth:
akarso accounts connect x
After authorizing, the account is connected and ready to use. You can connect accounts before subscribing. See pricing for plan limits.
Each workspace holds one account per platform, so commands address accounts by platform name. Any account or page selection (Facebook Pages, LinkedIn organizations, YouTube channels) happens inside the OAuth flow itself. See Connecting Accounts.

3. Publish your first post

Creating and publishing posts requires a subscription. Start a 7-day free trial with akarso subscribe, then:
akarso posts create \
  --text "Hello from Akarso!" \
  --platforms x
The output shows the created post details in YAML format. Pipe through yq to extract fields:
akarso posts create --text "Hello!" --platforms x | yq '.id'

Schedule a post for later

Use relative time shortcuts like 30m, 2h, 3d, or 1w:
akarso posts create \
  --text "Scheduled post" \
  --platforms x,linkedin \
  --scheduled-at 2h
Or pass an ISO 8601 date:
akarso posts create \
  --text "Launch day!" \
  --platforms x \
  --scheduled-at "2026-07-01T10:00:00Z"

Post to a different profile

Each API key is pinned to one profile (workspace). Override it per-command with --profile:
# See all profiles and their IDs
akarso profiles list

# Post from a specific profile
akarso posts create \
  --text "From the other workspace" \
  --platforms x \
  --profile 01JXYZ...

What's next

Powered byHolocron