CLI Setup

Install guide for CLI

The akta-pro-cli is a command-line client for the akta.pro REST API. A sibling of the Akta MCP server. Both are thin clients over the same endpoints; the CLI is the presentation layer for humans and shell scripts. It ships as its own self-contained distribution (akta-pro-cli) with no MCP-server code.

Installation

pipx

To install using pipx:

pipx install akta-pro-cli

uv

uv is Astral’s faster modern alternative to pipx. It writes a PATH-aware shim on first run, so no extra setup step is needed:

uv tool install akta-pro-cli

Requires uv to be installed first — see Astral’s install guide.

pip

Use pip when you’re embedding akta-pro-cli in a Python project (rather than using akta as a standalone tool — see the pipx or uv tabs for that):

pip install akta-pro-cli

Authentication

Authenticate using akta.pro API key. Visit playground.akta.pro to get your API key.

akta-pro login --api-key wk_...

akta-pro login validates the key against a free endpoint and stores it at ~/.config/akta/credentials.json (mode 0600; %APPDATA%\akta on Windows).

akta-pro login --api-key wk_...   # store without the prompt
akta-pro whoami                   # show the active key (masked), its source, and validate
akta-pro logout                   # remove the stored key