>_ ankicli

Install

Install ankicli

Use the one-command installer for your platform when you want a stable standalone binary path without asking a human to manage Python packaging directly.

Copy this guide

Paste it into Claude, Codex, or OpenClaw for structured context.

Paste this page into your LLM chat for structured context.

When to use this

  • You want the recommended install path for a human operator.
  • You want a consistent command to paste into docs, setup notes, or an LLM chat.

What the agent should know

  • Humans should usually install ankicli through the first-party script and verify it before handing the environment to an agent.
  • The installer targets GitHub Releases artifacts and verifies checksums before install.

Primary install commands

Choose the platform-appropriate command below. The script installs to a user-local path and runs a post-install backend check.

macOS

curl -fsSL https://raw.githubusercontent.com/Takhoffman/ankicli/main/scripts/install.sh | sh

Linux

curl -fsSL https://raw.githubusercontent.com/Takhoffman/ankicli/main/scripts/install.sh | sh

Windows

irm https://raw.githubusercontent.com/Takhoffman/ankicli/main/scripts/install.ps1 | iex

Fallback path

If you explicitly want the Python package path instead of the standalone artifact path, use pipx.

The PyPI distribution is `anki-agent-toolkit`; the installed command is still `ankicli`.

Fallback

pipx install anki-agent-toolkit

Verify after install

Always run the verification commands before using ankicli from an agent harness.

Verification

ankicli --version
ankicli --json doctor env
ankicli --json doctor backend

If the installer fails

Do not guess. Check the local runtime and backend state directly, then decide whether the issue is download-related, PATH-related, or backend-related.

  • Confirm the machine can reach GitHub Releases and raw GitHub content.
  • If the binary is installed but not found, add the printed user-local install directory to PATH and retry.
  • If the standalone installer path is blocked, use `pipx install anki-agent-toolkit` as the fallback path.

Install recovery baseline

ankicli --version
ankicli --json doctor env
ankicli --json doctor backend
ankicli --json doctor capabilities