Install it. verify it. hand it to your agent.
Put a safe, scriptable Anki control surface in front of your agent harness.
ankicli is a local-first Anki CLI for smart, semi-technical operators who want a real product they can install once, verify quickly, and then hand off to Claude, Codex, OpenClaw, or their own scripts.
Installed by humans. Operated by agents. Supervised with explicit JSON output, dry-run support, and safety-first write flows.
Install
Copy one command for your platform
The first-party installers download standalone release artifacts, verify checksums, install to a user-local path, and run a post-install health check.
macOS
One-command install
curl -fsSL https://raw.githubusercontent.com/Takhoffman/ankicli/main/scripts/install.sh | sh Verify:
ankicli --version
ankicli --json doctor backend Manual fallback:
pipx install anki-agent-toolkit Linux
One-command install
curl -fsSL https://raw.githubusercontent.com/Takhoffman/ankicli/main/scripts/install.sh | sh Verify:
ankicli --version
ankicli --json doctor backend Manual fallback:
pipx install anki-agent-toolkit Windows
One-command install
irm https://raw.githubusercontent.com/Takhoffman/ankicli/main/scripts/install.ps1 | iex Verify:
ankicli --version
ankicli --json doctor backend Manual fallback:
pipx install anki-agent-toolkit Workflow
How ankicli fits into a real operator workflow
1. Install and verify as a human
Run the platform installer, confirm the runtime is healthy, and resolve the right Anki profile before any real collection work.
2. Hand stable docs to your agent
Use the docs pages and their Copy Page buttons to paste structured context directly into Claude, Codex, or OpenClaw.
3. Let the agent operate safely
Use JSON output, dry-run-first mutation flows, explicit confirms, backups, and sync preflight instead of ad hoc terminal hacks.
Bundles
Skill folders and install targets
Open the shipped GitHub bundle for Codex, Claude Code, or OpenClaw, or grab the exact install command for your local skills home.
Study systems
Learning plans
Goal-driven study for travel, anime immersion, medical exams, and time-bounded progress.
Workflows
Recipes
Mechanics for image generation, TTS enrichment, source-to-deck workflows, and repair flows.
Reference
CLI guide
Command shape, targeting flags, help output, JSON mode, and safety switches.
Commands
Common tasks
Exact commands for inspection, search, note changes, backup, sync, and study.
Targeting
Profiles and collections
Use profile-aware commands or point directly at a collection file.
Safety
Sync and backups
Safe preflight, stored credentials, and local backup recovery flows.
Sessions
Study mode
Run local tutor-style sessions without turning the CLI into a fragile TUI.
Diagnostics
Troubleshooting
Debug install issues, runtime validation failures, and profile resolution problems.
Verify
Health check after install
ankicli --version
ankicli --json doctor env
ankicli --json doctor backend