Muninn

Muninn (雾尼) - An Extensible Reciting CLI.

中文文档  | Documentation

What is Muninn?

Muninn is a highly extensible CLI application designed to help you memorize anything. Instead of hardcoding questions, Muninn relies on a Plugin Architecture. You can install "Reciting Packs" created by others (like chemistry elements, GRE vocabulary, or historical events) or develop your own packs using Python.

Muninn acts as a "host" that provides:

1. A Smart Scheduling Algorithm (focuses on your weak-points).
2. Persistent State Management (remembers your progress across sessions).
3. A clean, distraction-free Terminal UI.

Installation & Usage

Install Muninn globally using uv (recommended) or pip:

# Using uv (Recommended)
uv tool install muninn-cli

# Or using pip
pip install muninn-cli

Quickstart

# Install a pack from GitHub
muninn install a1fredbao/muninn-chemistry-plugin

# Open the Textual library
muninn

# Or start a specific pack directly
muninn run muninn-chemistry-plugin

Commands

In the Textual library:

While answering, Enter submits the answer and Ctrl+Enter inserts a newline. Command+Enter also inserts a newline in terminals that forward the Command modifier to the application. The answer field grows with its contents, then scrolls internally when it reaches half of the available session height.

Write a Plugin

See full documentation at: a1fredbao.github.io/muninn