Quickstart
Three steps: log in, connect a channel, post.
1. Install and log in
12npm 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:
1akarso auth check
2. Connect a social account
Connect your first platform. The CLI opens your browser for OAuth:
1akarso accounts connect x
After authorizing, the account is connected and ready to use. Connecting is free for up to 3 channels — see pricing for plan limits.
Each workspace holds one account per platform, so commands address accounts by platform name. Some platforms (Facebook, Instagram, LinkedIn, YouTube, Google Business) also need a publishing target picked after OAuth — the connect flow shows the picker automatically. See Connecting Accounts.
3. Publish your first post
Publishing requires a subscription. Start a 7-day free trial with
akarso subscribe, then:1234akarso posts create \ --text "Hello from Akarso!" \ --platforms x \ --publish-now
The output shows the created post details in YAML format. Pipe through
yq to extract fields:1akarso posts create --text "Hello!" --platforms x --publish-now | yq '.id'
Schedule a post for later
Use relative time shortcuts like
30m, 2h, 3d, or 1w:1234akarso posts create \ --text "Scheduled post" \ --platforms x,linkedin \ --scheduled-at 2h
Or pass an ISO 8601 date:
1234akarso posts create \ --text "Launch day!" \ --platforms x \ --scheduled-at "2026-07-01T10:00:00Z"
What's next
- Connect more accounts across all 14 platforms
- Create multi-platform posts with media and scheduling
- Use Akarso from AI agents via the MCP server
- See plans and limits for channels, posts, and rate limits
- Browse the full CLI reference for all commands and options