Muninn

Muninn (雾尼) - An Extensible Training CLI.

中文文档  | Documentation

What is Muninn?

Muninn is a highly extensible CLI application designed to train memory and problem-solving skills. Instead of hardcoding questions, Muninn relies on a Plugin Architecture. You can install "Training 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.

A training group combines selected question types from any number of installed packs. Group selections and the active theme are stored in ~/.muninn/config.json.

Write a Plugin

See full documentation at: muninn.alfredbao.cn or the deepwiki page of Muninn.