Anki Cli

anki-cli

English | 简体中文

Anki 命令行工具 — 在终端管理你的 Anki 卡片、笔记和牌组。

通过 anki-connect 插件与本地 Anki 桌面版通信，提供完整的 CLI 命令和 TUI 复习界面。

功能特性

• 卡片管理 — 查询、暂停、搁置、标记、删除卡片
• 笔记管理 — 创建、更新、删除、批量浏览笔记
• 牌组管理 — 列出、创建、重命名、删除牌组
• TUI 复习 — 基于 Bubbletea 的终端复习界面，支持计时、评分反馈、标记、撤销、帮助面板
• 搜索 — 按关键词搜索笔记和卡片
• 统计 — 今日/周/月复习统计、复习预测
• AI 辅助 — 利用 LLM 生成卡片、解释知识点、推荐复习计划
• MCP Server — 通过 stdio 协议暴露 Anki 操作给 LLM 客户端（如 Claude）
• Skill Ready — 通过 Skill 机制集成到 Cherry Studio 等 AI 客户端
• 导入导出 — 导入和导出 .apkg 文件
• 媒体管理 — 上传、下载、删除媒体文件

快速开始

前提条件

1. 安装 Anki 桌面版
2. 安装 anki-connect 插件
3. 启动 Anki 并保持运行

安装

git clone https://github.com/cicbyte/anki-cli.git
cd anki-cli
go build -o anki-cli

基本使用

# 测试连接
./anki-cli ping

# 查看所有牌组
./anki-cli deck list

# 复习指定牌组
./anki-cli review --deck "Default"

# 进入 TUI 界面
./anki-cli tui

# 搜索笔记
./anki-cli search "deck:Default java"

命令一览

所有命令支持 -f json 输出 JSON 格式。

界面展示

TUI 复习界面

AI 辅助

MCP Server

Skill 集成

TUI 复习界面

# 直接进入指定牌组复习
./anki-cli review --deck "English"

# 预览模式（不提交评分）
./anki-cli review --deck "English" --preview

# 限制复习数量
./anki-cli review --deck "English" --limit 10

TUI 快捷键：

MCP Server

将 anki-cli 作为 MCP Server 暴露给 LLM 客户端：

{
  "mcpServers": {
    "anki": {
      "command": "anki-cli",
      "args": ["mcp"]
    }
  }
}

可用工具：anki_search_notes、anki_get_note、anki_create_note、anki_update_note、anki_delete_note、anki_list_decks、anki_get_due_cards、anki_review_card、anki_get_stats、anki_list_models

配置

配置文件位置：~/.ciclebyte/anki-cli/config/config.yaml

# 查看所有配置项
./anki-cli config list

# 获取单个配置
./anki-cli config get server.url

# 设置配置
./anki-cli config set server.url http://localhost:8765

技术栈

• Go 1.25+
• Cobra — CLI 框架
• Bubble Tea — TUI 框架
• Glamour — Markdown 终端渲染
• GORM — ORM
• Zap — 日志
• mcp-go — MCP 协议

许可证

MIT © 2026 cicbyte