Install
12npm install -g akarso akarso auth login
This opens your browser for sign-in (device flow, safe for agents) and saves an API key to
~/.akarso/config.json. Verify with akarso auth check.For CI or headless environments, set the key directly:
123akarso auth set --key ak_your_key_here # or use the env var export AKARSO_API_KEY=ak_your_key_here
Use with AI agents
Skill
Akarso ships with a skill that teaches any compatible AI agent (Claude Code, Cursor, Kimaki, OpenCode, etc.) how to use the CLI. Install it so agents can post, schedule, and manage social accounts without extra prompting:
1kimaki skill install remorses/akarso
Once installed, the agent loads the skill automatically when you ask it to post to social media, schedule content, or manage accounts.
MCP server
Akarso can also run as an MCP server, exposing every command as a tool that MCP-compatible agents can call directly:
12345# Local stdio server (can upload local files) akarso mcp # Or use the hosted server (no install, OAuth sign-in) claude mcp add --transport http akarso https://akarso.co/mcp
Output format
All structured data goes to stdout as YAML, pipeable through
yq. Pass --json for raw JSON (pipeable through jq). Progress and errors go to stderr, so agents can parse stdout cleanly.12akarso posts list --json | jq '.[0].id' akarso accounts list | yq '.[].type'
Version: 0.0.1
Commands
| Command | Description |
auth login | Login via browser (device flow). Prints a URL, keeps polling in a background daemon, and returns immediately. Verify with akarso auth check. |
auth set | Save API key manually (pass it with --key) |
auth check | Verify API key is valid (exits 1 if not logged in) |
auth logout | Clear saved credentials for the current server |
subscribe | Open the dashboard to subscribe or manage your plan |
profiles list | List the profiles (workspaces) of your organization |
profiles create | Create a new profile (admin only, plan limits apply) |
accounts connect | Connect a social account |
accounts list | List connected social accounts |
accounts get | Get the connected account for a platform, including its selectable channels |
accounts health | Check connection health for all accounts |
accounts disconnect | Disconnect the platform account from your workspace |
accounts set-channel | Select the publishing target (Page, organization, channel, or location) for a connected account |
posts create | Create, schedule, or publish a post. Use --publish-now or --scheduled-at; neither saves a draft. |
posts list | List posts |
posts get | Get post details |
posts delete | Delete a post (skip confirmation with --force) |
posts retry | Retry a failed post |
media upload | Upload media from a local file path or https URL, returns an upload ID for use in posts |
inbox sync | Import the comments on a published post |
inbox syncs | List comment import jobs and their status |
inbox comments | List imported comments (run inbox sync first) |
inbox reply | Publish a reply in a post comment section |
inbox comment-action | Moderate an imported comment |
inbox reviews | List imported Google Business reviews (run inbox reviews-sync first) |
inbox reviews-sync | Import your Google Business location reviews |
inbox review-reply | Reply to a Google Business review as the owner |
mcp | Start Akarso as an MCP server over stdio |
completions install | Install shell completions |
completions uninstall | Remove shell completions |
completions script | Print the completion script to stdout |
Global Options
| Option | Default | Description |
--api-key [key] | - | API key (overrides AKARSO_API_KEY env and ~/.akarso/config.json) |
--api-url [url] | - | Server URL (overrides AKARSO_API_URL env, defaults to akarso.co) |
--json | - | Output raw JSON instead of YAML |
-h, --help | - | Display this message |
-v, --version | - | Display version number |