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.API keys are scoped to one organization and one profile. Commands using that key publish from the pinned profile's connected accounts. Override the profile per-command with
--profile:12345# List profiles to find their IDs akarso profiles list # Post from a specific profile akarso posts create --text "Hello!" --platforms x --profile 01JXYZ...
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.3.0
Commands
| Command | Description |
auth login | Authenticate with Akarso via browser-based device flow. |
auth set | Save an API key manually instead of using auth login. |
auth check | Verify the current API key is valid and print the active profile. |
auth logout | Clear saved credentials for the current server. |
subscribe | Open the Akarso dashboard to subscribe or manage your plan. |
profiles list | List all profiles (workspaces) in your organization. |
profiles create | Create a new profile (workspace) in your organization. |
profiles rename | Rename a profile (workspace) in your organization. |
accounts connect | Connect a social media account via OAuth. |
accounts list | List all connected social accounts in the current workspace. |
accounts get | Get detailed information about the connected account for a specific platform. |
accounts disconnect | Disconnect a social account from your workspace. |
accounts pinterest-boards | List the boards of the connected Pinterest account. |
posts create | Create a social media post as a draft, publish it immediately, or schedule it for later. |
posts list | List posts in the current workspace, with optional filters. |
posts get | Get full details for a single post by its ID. |
posts delete | Delete a post by its ID. This action cannot be undone. |
posts reschedule | Move a scheduled post to a new publish time. |
posts cancel | Cancel a scheduled post before it publishes. |
drafts list | List the drafts of the current workspace, newest first. |
drafts get | Get full details for a single draft by its ID. |
drafts delete | Delete a draft by its ID. This action cannot be undone. |
drafts publish | Publish a draft immediately, or schedule it with --scheduled-at. |
media upload | Upload a local media file, returning a public URL for use with posts create --media. |
mcp | Start Akarso as a local MCP (Model Context Protocol) 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) |
--profile [id] | - | Profile (workspace) ID to operate on, overriding the API key's pinned profile. Use profiles list to see available IDs. |
--json | - | Output raw JSON instead of YAML |
-h, --help | - | Display this message |
-v, --version | - | Display version number |