CLI & SDK

The appliku package gives you two ways to interact with Appliku programmatically:

• CLI — a command-line tool for managing apps, deployments, domains, datastores, and more
• Python SDK — a library for scripting, automation, and CI/CD integrations

Both are shipped in the same PyPI package and require Python 3.10+.

Installation

Install uv (recommended)

uv is the recommended way to install and manage the Appliku CLI.

macOS and Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

After installation, restart your shell or verify it works:

uv --version

Install the CLI

Install appliku as a standalone tool — it will be available globally as the appliku command:

uv tool install appliku

Verify the installation:

appliku --help

Install the SDK (for Python projects)

To use the SDK inside a Python project, add it as a dependency:

uv add appliku

Updating

To upgrade the CLI to the latest version:

uv tool upgrade appliku

Alternative: pip

If you prefer pip, the package is also available that way:

pip install appliku

Authentication

Browser login (recommended)

Running appliku login starts a browser-based device authorization flow. Once you approve the session in your browser, the CLI saves the API token to ~/.config/appliku/config.toml.

appliku login

During the browser authorization step you will be asked to choose an access level before confirming:

Access level	What it can do
Full access	Read and write — manage apps, trigger deployments, update config, and more
Read-only	Read only — view logs, deployment history, app configuration, and status

You must select one of the two options before the "Authorize" button becomes active. Choose Read-only when you want to limit what the token can do — for example, when giving a CI job or an AI coding agent access to logs without the ability to change anything.

Giving AI agents read-only access

When you connect an AI coding assistant (Claude Code, Cursor, Copilot, etc.) to Appliku via the CLI, select Read-only access. The agent can then read logs, check deployment status, and inspect configuration, but it cannot deploy, modify settings, or perform any destructive action. See Using AI Coding Assistants with Appliku for details.

Direct token login

You can also log in by passing your API token directly:

appliku login --token YOUR_API_TOKEN

Useful auth commands

appliku whoami   # Show the currently authenticated user
appliku logout   # Remove the saved token

Environment variable

For CI/CD pipelines and scripts, set the APPLIKU_TOKEN environment variable instead of logging in interactively:

export APPLIKU_TOKEN=YOUR_API_TOKEN

CI/CD

In GitHub Actions, GitLab CI, or any other CI system, store your API token as a secret and expose it as APPLIKU_TOKEN. The CLI and SDK both pick it up automatically — no config file needed.

Token resolution order

When making API calls, the SDK and CLI resolve the token in this order:

1. Explicit token passed as a parameter — Appliku(token="...") or appliku login --token ...
2. APPLIKU_TOKEN environment variable
3. Token stored in ~/.config/appliku/config.toml

Claude Code Skill

If you use Claude Code, install the Appliku skill to give the agent full knowledge of the CLI and SDK in every session — no manual context needed:

npx skills add appliku/skill -g -a claude-code

See Using AI Coding Assistants with Appliku for details.

Next steps

• CLI Reference — full command listing for all resources
• Python SDK — SDK quick start, resource reference, and error handling