KirishAkkaunt yaratish
KirishAkkaunt yaratish

mini-kode

Ochiq manbalardan

Taʼlim uchun moʻljallangan AI kodlash agenti CLI

Mashina tarjimasi · Asl matnni koʻrsatish

An educational AI coding agent CLI

AI vositaKategoriya: AI vositalariOpen sourcemaʼlumot tekshirilgan: 16-okt, 2026
SolishtirishToʻplamga

Sharh

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

Oʻrnatish

Buyruqlar faqat koʻrsatiladi, marketpleys ularni bajarmaydi. Rasmiy hujjatlar bilan solishtiring.
  • Til paketlari reyestrinodejsOchiq manbalardanpaket manifestidan — reyestrda chop etilgani tekshirilmagan
    npm install -g mini-kode

    Tekshirilmagan: oʻrnatishdan oldin reyestrdagi paket aynan shu loyihaga tegishli ekanini tekshiring.

    www.npmjs.com/package/mini-kode ↗
  • Manbadan yigʻishOchiq manbalardankatalog metamaʼlumotlaridan

    Manbadan yigʻish: tekshirilgan yigʻish retsepti yoʻq — repozitoriy koʻrsatmalariga amal qiling.

    github.com/minmaxflow/mini-kode ↗

Moslik

«Nomaʼlum» dalil topilmaganini bildiradi, mahsulot mos emasligini emas.
PlatformaHolatArxitekturaDalilIshonchlilik
WindowsNomaʼlum———
macOSNomaʼlum———
LinuxNomaʼlum———
Web browserNomaʼlum———
Server / self-hostedNomaʼlum———
Container (OCI)Nomaʼlum———
Node.jsMos—paket manifesti: package.json name0.60

Relizlar

tekshirilgan: 30-okt, 2026
Manbada relizlar topilmadi.

Sifat profili

algoritm quality-v1.0 · baholangan 16-okt, 2026
Sifat bahosi62
Xavf bahosi0
Ishonchlilik 1.00
Sifat bahosi va xavf bahosi — turli koʻrsatkichlar. Yuqori sifat xavfsizlikni kafolatlamaydi.

Baho tarkibi

Qoʻllab-quvvatlash · 206
last activity 346 days ago
Hujjatlar · 1515
README 4900 chars, description present
Foydalanishga tayyorlik · 159
install instructions: yes; releases: no
Metamaʼlumotlar · 108
3/4 of description, homepage, license, topics
Relizlar · 102
0 release(s)
Kategoriya aniqligi · 107
classifier confidence 0.65
Ommaboplik · 106
307 stars (log-dampened, 10k = max)
Litsenziya aniqligi · 55
SPDX MIT
Hamjamiyat · 55
issues enabled, 31 forks

Litsenziya

MIT
Litsenziya maʼlumrepozitoriy xostingi maʼlumotlariga koʻra

Bu katalog siyosati holati, yuridik xulosa emas.

Manbalar

github.com/minmaxflow/mini-kodeAsosiy★ 307 yulduzfaollik: 4-noy, 2025Asosiy repozitoriy · Ishonchlilik 1.00

Sharhlar

Sharh yozish uchun kiring

Hali sharhlar yoʻq.

Muqobillar

zeroOʻxshash
Sizga boʻysunadigan kodlash agenti: sizning modelingiz, sizning mashinangiz, sizning qoidalaringiz.MIT · AI vositalari
jcodeOʻxshash
Rust tilida yozilgan yuqori unumdorlikdagi kodlash agenti muhitiMIT · AI vositalari
momo-codeOʻxshash
MOMO CODE — siz bilan birga rivojlanadigan AI kodlash agentiAI vositalari
code2promptOʻxshash
Kod bazasini bitta LLM promptiga aylantiradigan CLI vosita: manba fayllari daraxti, prompt shablonlari va tokenlarni hisoblash imkoniyatlari bilan.MIT · AI vositalari
openscienceOʻxshash
Ilmiy tadqiqotlar uchun ochiq manbali sun’iy intellekt ish muhitiApache-2.0 · AI vositalari
opensrcOʻxshash
AI kodlash agentlariga chuqurroq kontekst berish uchun npm paketlarining manba kodini olishApache-2.0 · AI vositalari

README

minmaxflow/mini-kode dan · litsenziya MIT · yuklangan 30-okt, 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:

Repozitoriyni ochish ↗