Sign inCreate account
Sign inCreate account

mini-kode

From public sources

An educational AI coding agent CLI

AI toolCategory: AI ToolsOpen sourcedata checked Oct 16, 2026
Add to compareAdd to collection

Overview

  • ai
  • cli
  • coding-agent
  • educational
  • human-in-the-loop-ai
  • llm
  • tool-system

Installation

Commands are shown, never run by the marketplace. Check them against the official documentation.
  • Language package registrynodejsFrom public sourcesfrom the package manifest — publication on the registry is not verified
    npm install -g mini-kode

    Not verified: check that this package in the registry belongs to this project before installing.

    www.npmjs.com/package/mini-kode ↗
  • Build from sourceFrom public sourcesfrom catalog metadata

    Build from source: no validated build recipe — follow the repository instructions.

    github.com/minmaxflow/mini-kode ↗

Compatibility

Unknown means no evidence was found — not that the product is incompatible.
PlatformStatusArchitectureEvidenceConfidence
WindowsUnknown———
macOSUnknown———
LinuxUnknown———
Web browserUnknown———
Server / self-hostedUnknown———
Container (OCI)Unknown———
Node.jsCompatible—package manifest: package.json name0.60

Releases

checked Oct 30, 2026
No releases found on the source.

Quality profile

algorithm quality-v1.0 · assessed Oct 16, 2026
Quality Score62
Risk Score0
Confidence 1.00
Quality Score and Risk Score are different measures. A high score does not guarantee safety.

Score components

Maintenance · 206
last activity 346 days ago
Documentation · 1515
README 4900 chars, description present
Ready to use · 159
install instructions: yes; releases: no
Metadata · 108
3/4 of description, homepage, license, topics
Releases · 102
0 release(s)
Category confidence · 107
classifier confidence 0.65
Adoption · 106
307 stars (log-dampened, 10k = max)
License clarity · 55
SPDX MIT
Community · 55
issues enabled, 31 forks

License

MIT
Known licensefrom the repository host

This is the catalog policy status, not legal advice.

Sources

github.com/minmaxflow/mini-kodePrimary★ 307 starslast activity Nov 4, 2025Primary repository · Confidence 1.00

Reviews

Sign in to write a review

No reviews yet.

Alternatives

zeroSimilar
The coding agent that answers to you, your model, your machine, your rules.MIT · AI Tools
jcodeSimilar
High performance coding agent harness written in rustMIT · AI Tools
momo-codeSimilar
MOMO CODE — AI coding agent that evolves with youAI Tools
code2promptSimilar
A CLI tool to convert your codebase into a single LLM prompt with source tree, prompt templating, and token counting.MIT · AI Tools
openscienceSimilar
The open-source AI workbench for scientific researchApache-2.0 · AI Tools
opensrcSimilar
Fetch source code for npm packages to give AI coding agents deeper contextApache-2.0 · AI Tools

README

From minmaxflow/mini-kode · license MIT · fetched Oct 30, 2026

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):

export DEEPSEEK_API_KEY="your-deepseek-api-key"

Or use GLM (智谱AI) (tested and verified):

export GLM_API_KEY="your-glm-api-key"

Or use OpenAI compatible API:

export OPENAI_API_KEY="your-openai-api-key"
# or
MINIKODE_API_KEY="your-api-key"
MINIKODE_BASE_URL="https://your-api-provider.com/v1"
MINIKODE_MODEL="your-model-name"

Run Mini-Kode

# Interactive mode (launch UI)
mini-kode

# Non-interactive mode (direct execution)
mini-kode "help me fix the bug in auth.ts"

🔧 Development Quick Start

Prerequisites

  • Bun
  • pnpm

Install Dependencies

pnpm install

Development Commands

# Development mode with file watching
pnpm run dev

# Build
pnpm run build

# Test
pnpm run test

📖 Learning Resources

Want to dive deeper into the system architecture? Check out docs/README.md for complete system documentation and architecture explanations.

📚 Project Analysis

For a comprehensive code analysis and walkthrough, visit Mini-Kode Deep Analysis - an in-depth exploration of the codebase architecture, design patterns, and implementation details.

🧠 Project Memory

Mini-Kode automatically uses AGENTS.md file in your project root to provide context-aware assistance:

  • Automatic Context: System reads AGENTS.md to understand your project
  • Customizable: Edit AGENTS.md to include project-specific information
  • Persistent Memory: Maintains project context across sessions

🏗️ Project Structure

src/
├── tools/          # Tool system and individual tools
├── ui/             # Ink-based CLI interface components
├── llm/            # LLM client and streaming integration
├── permissions/    # Two-layer permission system
├── config/         # Configuration management
├── cli/            # CLI framework and commands
├── agent/          # Core agent logic
├── sessions/       # Session management
└── utils/          # Shared utilities

🛠️ Tech Stack

  • TypeScript - Static type checking
  • pnpm - Package management
  • Ink - React terminal UI
  • OpenAI SDK - LLM integration (supports DeepSeek/OpenAI/compatible APIs)
  • Vitest - Testing framework
  • Zod - Runtime type validation
  • Commander - CLI framework

🚧 Future Plans

  1. Session Persistence and Resume - Save and restore agent sessions
  2. LLM Built-in Tool Integration - Support for LLM's native tool capabilities (note: DeepSeek currently doesn't support web search tools)
  3. Image Input Support - Process and analyze image inputs
  4. Sub Agents Functionality - Hierarchical agent delegation
  5. Reasoning Model Support - Integration with reasoning-focused models
  6. Tool Call Message Streaming - Real-time streaming of tool execution
  7. Context Caching - Smart caching of conversation context to reduce token usage

📚 References

This project was inspired by and references the following resources:

Open the repository ↗