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"

命令一览

命令	说明
ping	测试 anki-connect 连接
deck	管理牌组（list / create / rename / delete / info）
note	管理笔记（list / get / create / update / delete）
card	管理卡片（list / get / info / suspend / bury / delete）
review	复习卡片（TUI 模式，支持 --deck / --limit / --preview）
tui	启动 TUI 界面（支持 --deck / --browse）
search	搜索笔记或卡片
stats	查看复习统计（支持 --period / --forecast）
ai	AI 辅助（generate / explain / suggest / chat）
import	导入 .apkg 文件
export	导出牌组为 .apkg 文件
media	管理媒体文件（list / get / store / delete）
tag	管理标签
model	管理笔记模型
config	管理配置（list / get / set）
mcp	启动 MCP Server（stdio 模式）
version	显示版本信息

所有命令支持 -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 快捷键：

按键	功能
Space / Enter	翻转卡片
1 / 2 / 3 / 4	评分（Again / Hard / Good / Easy）
j / k / ↑ / ↓	滚动内容
h / l / ← / →	导航卡片
f	循环标记颜色
e	编辑笔记
u	撤销上次评分
r	刷新待复习卡片
s	跳过卡片
?	帮助面板
q / Esc	退出

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