anipy-cli

anipy-cli — Anime Streaming via Claude Code

Overview

anipy-cli is a Python CLI tool for searching, streaming, and downloading anime. This skill enables Claude Code to act as a natural language interface for anipy-cli on Windows, handling dependency management, player routing, and all CLI operations non-interactively.

Shell Requirement: the Bash Tool (Git Bash)

Run all anipy-cli operations through the Bash tool. On Windows, Claude Code's Bash tool executes the installed Git Bash (MSYS2) — it is a real prerequisite, not bundled. Every procedure in this skill and its references assumes MSYS2 semantics: /c/... drive paths, ~/.local/bin, 2>/dev/null.

PowerShell is NOT a working alternative. The setup and repair flows only work in Git Bash. If a single bare invocation must run in PowerShell for some reason, the env-prefix form is $env:PYTHONIOENCODING='utf-8'; anipy-cli ... 2>&1 — bare invocations only; switch back to the Bash tool for everything else.

Dependency Repair Chain

When a command fails due to a missing or broken dependency, diagnose and repair using this chain. Do NOT run these checks upfront — only when a failure occurs. Each installation or upgrade requires AskUserQuestion confirmation — never install silently.

Repair order:

1. uv — uv --version → if missing, install (see references/setup-guide.md section 1). If both pwsh.exe and powershell.exe install methods fail, STOP and tell the user to install PowerShell 7 from the Microsoft Store, then restart their terminal.
2. anipy-cli — anipy-cli --version → if missing, uv tool install anipy-cli
3. Video player — check mpv (where.exe mpv), then vlc (where.exe vlc + common paths) → if neither found, ask user which to install (see references/setup-guide.md sections 3-5)
4. Config player_path — run anipy-cli --config-path to get the path, then verify the config file exists. If not, run anipy-cli --version 2>&1 to attempt generation; if config still missing, run a search command like anipy-cli -s "test:1:sub" 2>&1 to trigger full initialization. Then verify player_path matches an installed player, update if needed
5. Provider drift (installed but broken) — observable signal in output: search matches a title, then stream extraction dies with a one-line A fatal error of type [...] message (e.g., 'NoneType' object is not subscriptable). The detailed traceback is NOT in the output — it goes to the log file at the "Logs can be found at " location printed alongside the error. Read that log to confirm the crash is inside anipy_api/provider/...; if so, the provider's API has likely changed and the installed anipy-cli can no longer parse its responses. Upstream patches provider breakage frequently. Confirm via AskUserQuestion, then uv tool upgrade anipy-cli and retry the original command once. If it still fails after upgrading, the provider may be down or the fix unreleased — see references/troubleshooting.md § Stream extraction crashes.