MiMo-Code  by XiaomiMiMo

Terminal AI coding agent with persistent cross-session memory

Created 4 days ago

New!

7,785 stars

Top 6.7% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

MiMoCode is a terminal-native AI coding assistant designed to provide deep project understanding across development sessions through its persistent memory system. It targets developers and power users seeking an intelligent agent capable of reading/writing code, managing Git, running commands, and continuously improving its project context. The primary benefit is a more coherent and efficient development workflow, reducing the need for repeated context re-establishment.

How It Works

MiMoCode employs a persistent memory architecture leveraging SQLite FTS5 for project knowledge, session checkpoints, and scratch notes, ensuring context is automatically retained and injected across sessions. Its intelligent context management dynamically reconstructs context from checkpoints, memory, and task progress when token limits are approached, using a budgeted injection strategy. A subagent system allows the primary agent to spawn parallel, on-demand workers with lifecycle tracking. The unique Compose Mode orchestrates a full development lifecycle from specification to deployment, including planning, execution, and verification, while a goal-setting mechanism with an independent judge model prevents premature task completion.

Quick Start & Requirements

Installation is available via a one-line curl script (curl -fsSL https://mimo.xiaomi.com/install | bash) or npm (npm install -g @mimo-ai/cli). The initial launch guides users through configuration, offering options like the limited-time free MiMo Auto, Xiaomi MiMo Platform (OAuth), Claude Code import, or custom OpenAI-compatible API providers. No specific hardware or software prerequisites beyond a shell environment are listed, though LLM provider requirements may vary.

Highlighted Details

  • Persistent Memory: Cross-session context storage using SQLite FTS5 (MEMORY.md, checkpoint.md, notes.md).
  • Intelligent Context Management: Automatic checkpointing and context reconstruction based on session state and project memory.
  • Subagent System: On-demand creation of parallel agents for concurrent task execution.
  • Compose Mode: Structured workflow for end-to-end development, including planning, TDD, debugging, and merging.
  • Dream & Distill: Self-improvement features for extracting persistent knowledge and packaging reusable workflows.
  • Voice Input: Real-time streaming voice transcription (requires MiMo login).
  • Goal-Driven Autonomy: /goal command with judge model validation to ensure task completion criteria are met.

Maintenance & Community

MiMoCode is presented as a fork of OpenCode, inheriting its core capabilities. A community group chat is accessible via a QR code mentioned in the README. Specific details on active contributors, sponsorships, or a public roadmap were not detailed in the provided text.

Licensing & Compatibility

The source code is licensed under the MIT License. However, usage is also subject to separate "Use Restrictions," "MiMo Terms of Service" (for Xiaomi MiMo-hosted services), and the "MiMo Trademark Policy." The implications of these additional terms, particularly for commercial use or integration into closed-source projects, require careful review of the linked policies.

Limitations & Caveats

The free "MiMo Auto" channel is time-limited. Voice input functionality necessitates logging into the Xiaomi MiMo Platform. The "Max Mode" for parallel reasoning is marked as experimental. Compatibility and potential restrictions for commercial use are not fully delineated by the MIT license alone, due to the additional "Use Restrictions" policy.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
181
Issues (30d)
339
Star History
7,867 stars in the last 4 days

Explore Similar Projects

Starred by Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind), Christian Laforte Christian Laforte(Distinguished Engineer at NVIDIA; Former CTO at Stability AI), and
5 more.

ruflo by ruvnet

1.5%
59k
AI orchestration platform for complex development workflows
Created 1 year ago
Updated 1 day ago
Feedback? Help us improve.