minmaxflow/mini-kode — An educational AI coding agent CLI

Mini-Kode

An educational AI coding assistant project that helps you understand and hack modern AI coding assistant systems.

🌟 Why Mini-Kode?

Demo

Mini-Kode is an educational project designed to help developers understand modern Coding Agent architecture. We strike the perfect balance between overly complex open-source projects and simplistic demo examples, offering a complete yet manageable implementation (14K lines of production code) with:

📚 Education-First Design - Clean architecture built on OpenAI SDK with thoughtful type design and comprehensive comments
🛠️ Complete Tool System - Unified interface with comprehensive tools for file operations, search, and command execution
🔌 MCP Integration - Connect to external MCP servers for extended functionality
⚙️ Multi-LLM Support - Compatible with OpenAI APIs, including GLM, DeepSeek, and other mainstream models
🤖 Agent Loop - Complete LLM workflow with streaming responses and human-in-the-loop permission approval
🎨 Modern UI - React/Ink-based terminal interface with theme support

🚀 Quick Start (Install & Use)

Install Globally

npm install -g mini-kode

Set Up API Key

DeepSeek (tested and verified):

mini-kode

Quick Overview

Scores

Trust Score

Maintenance

Popularity

Star History

Snapshot Versions

Alternatives

claude-mem

learn-claude-code

gpt-engineer

ruflo

career-ops

cherry-studio

Community Reviews

README

Mini-Kode

🌟 Why Mini-Kode?

🚀 Quick Start (Install & Use)

Install Globally

Set Up API Key