Skip to main content

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​

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​

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 levelWhat it can do
Full accessRead and write — manage apps, trigger deployments, update config, and more
Read-onlyRead 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