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

Connecting Accounts

Akarso supports 10 social platforms. Each account connects through an OAuth flow in your browser.
Each workspace holds one account per platform, so commands address accounts by platform name (x, linkedin, googlebusiness, ...) instead of account IDs. Connecting a platform that is already connected replaces the existing account.
Connecting accounts does not require a subscription. Without one you can connect up to 3 accounts; subscribing raises the limit based on your plan.

Connect via CLI

The simplest way to connect is the interactive command:
akarso accounts connect
This prompts you to pick a platform and opens the browser. If you know which platform:
akarso accounts connect x

How the OAuth flow works

  CLI                        Browser                     Akarso
   │                            │                           │
   ├── opens connect URL ──────>│                           │
   │                            ├── user authorizes ───────>│
   │                            │   (+ picks Page/channel   │
   │                            │    when the platform      │
   │                            │    has several)           │
   │                            │<── redirect to callback ──┤
   │                            │                           │
   ▼                            ▼                           ▼
  Done                   "Connected" page             Account saved
  1. The CLI builds a connect URL for your workspace
  2. Your browser opens the OAuth page for the chosen platform
  3. You authorize Akarso to access your account — platforms with multiple publishing targets (Facebook Pages, LinkedIn organizations, YouTube channels) let you pick one during the flow
  4. The platform redirects back to the Akarso callback page
  5. The account is connected and ready to use
There is no separate channel-selection step: whichever Page, organization, or channel you pick during authorization becomes the publishing target.

Bluesky

Bluesky has no browser OAuth. Instead, the connect page asks for your handle and an app password:
akarso accounts connect bluesky
Generate an app password at bsky.app/settings/app-passwords — never use your account password.

List connected accounts

akarso accounts list

Get account details

Accounts are addressed by platform name:
akarso accounts get facebook

Pinterest boards

Pinterest pins always target a board. List the connected account's boards to find the ID for posts create --pinterest-board:
akarso accounts pinterest-boards

Disconnect an account

akarso accounts disconnect x
If posting to a platform starts failing with authorization errors (expired or revoked tokens), reconnect it with akarso accounts connect.
Powered byHolocron