Skip to content

CLI

@anakonn/ankk is a Bun-based CLI tool powered by the ANKK Public API.

  • Bun 1.3 or higher
  • A Public API key scoped to your brand

Run without installing:

Terminal window
bunx @anakonn/ankk --json health

Global installation:

Terminal window
bun install -g @anakonn/ankk
ankk --json health

Global configuration:

Terminal window
ankk config setup --scope global

Project-local configuration:

Terminal window
ankk config setup --scope project

Configuration resolution order:

  1. CLI options such as --api-key and --config
  2. ANKK_API_KEY environment variable
  3. Project-level .ankk/config.json
  4. Global ~/.ankk/config.json

Defaults to https://api.ankk.app if not configured. ankk config show displays current settings without exposing the full API key.

CommandPurpose
healthCheck API health
upgradeUpgrade global installation
openapiView or fetch OpenAPI schema
brandManage brand details scoped to the API key
connectionsInspect SNS connections
contentsList, query, publish, and cancel scheduled content
commentsFetch, post, refresh, and moderate comments
reply-jobsCreate and monitor reply jobs
analyticsFetch analytics and metric summaries
webhooksManage Webhook subscriptions
configManage CLI configuration

To view available options for any command, run ankk <command> --help.

payload.json:

{
"connection_id": "<connection_id>",
"idempotency_key": "cli-publish-001",
"text": "Published via CLI."
}
Terminal window
ankk contents publish --file payload.json
ankk contents publish --file payload.json --scheduled-for 2026-08-10T09:00:00Z

Use --json in scripts and AI clients:

Terminal window
ankk --json connections list
ankk --json contents get <content_id>