VERSION 1.0 // MULTI-LANGUAGE AGENT FRAMEWORK 1.0 版本 // 多语言智能体框架

Build
Agents
Faster.

极速构建
智能体
框架。

A lightweight, multi-language AI agent framework with native tool use, SSE streaming, and a ReAct event loop. No bloated abstractions.

一个轻量级、多语言的 AI 智能体框架，原生支持工具调用、SSE 流式输出和 ReAct 事件循环。拒绝臃肿抽象。

Clone Repository 克隆代码库 View Documentation 查看文档
Code Overview

Core
Mechanics

核心
机制

A fully functional agent prototype built for deep understanding. Not just a toy, but a robust architecture.

为深度理解而构建的全功能智能体原型。不仅仅是玩具，而是健壮的架构。

01

Multi-Model 多模型支持

Support for Anthropic and OpenAI-compatible interfaces (DeepSeek, Qwen, Kimi). Seamless switching via env vars. 支持 Anthropic 和兼容 OpenAI 的接口 (DeepSeek, Qwen, Kimi)。通过环境变量无缝切换。

02

Streaming 流式输出

Native SSE streaming with real-time reasoning content (thinking process) display for advanced models. 原生 SSE 流式输出，支持高级模型实时展示推理过程（思维链）。

03

Tool Use 工具调用

Built-in BashTool, FileReadTool, and FileWriteTool for native environment interaction and code modification. 内置 BashTool、FileReadTool 和 FileWriteTool，实现原生环境交互与代码修改。

04

ReAct Loop ReAct 循环

Autonomous message event loop allowing multiple tool invocations until the task is marked complete. 自主消息事件循环，允许连续多次调用工具，直至任务标记完成。

// REASONING_ENGINE.LOG STATUS: ACTIVE
Reasoning Output

Four
Languages.

四大
语言。

One unified architecture implemented across four major ecosystems. Learn agent concepts in the language you know best.

同一套统一架构在四大主流生态系统中的实现。用你最熟悉的语言学习智能体概念。

TS

TypeScript

COMPLETED 已完成

Native implementation using pure functional architecture. Flawless streaming parsing and tool scheduling. 使用纯函数式架构的原生实现。完美的流式解析与工具调度。

PY

Python

COMPLETED 已完成

Pythonic asynchronous agent using asyncio and strong type hinting. 使用 asyncio 和强类型提示的 Pythonic 异步智能体。

GO

Go

COMPLETED 已完成

Extreme concurrency and performance utilizing Goroutines and Channels. 利用 Goroutines 和 Channels 达到极致并发与性能。

RS

Rust

COMPLETED 已完成

Memory safe, zero-cost abstractions, compiled to native binaries with minimal footprint. 内存安全，零成本抽象，编译为体积最小的原生二进制文件。

Capabilities 能力展示

BASH_TOOL_SECURITY BashTool.ts

BashTool Security Sandbox BashTool 防爆拦截机制

Intercepts blocking commands like `sleep 15` to prevent the agent from freezing the main thread. 精准识别长时的“孤狼” sleep 命令并拦截，防止主进程被无意义阻塞，实现极强的安全与防爆机制。

BashTool 1 BashTool 2
MEMORY_MANAGER MemoryManager.ts

Minimalist Memory Manager 大道至简的记忆管理器

Pure file-system-based two-step memory. Triggers automatic truncation when limits are exceeded to save tokens. 纯文件系统两步走法则。当记录超过限制时，触发记忆防爆机制自动截断，确保上下文精简且不超 Token。

MemoryManager 1 MemoryManager 2
AGENT_TOOL_SANDBOX AgentTool.ts

Agent Sub-processes & Sandbox AgentTool：影分身与安全沙盒

Spawns sub-agents in isolated Git worktrees to test unstable scripts without affecting the main branch. 派生子代理在完全平行、物理隔离的 Git worktree 沙箱目录中执行任务，完成后自动清理，主分支毫发无损。

AgentTool 1 AgentTool 2
MCP_PLUGINS MCPTool.ts

MCP Plugins & Transparent Proxy MCP 插件系统与透明代理

Full support for the Model Context Protocol. Transparently proxies remote tools via stdio IPC. 完全支持官方 MCP！通过 stdio 跨进程启动插件，并利用透明代理将远端工具封装成本地调用，实现零耦合扩展。

MCP 1 MCP 2
E2E_APP_GENERATION wuziqi.html

Zero to App 从零构建应用

"Write a Gomoku web game." The agent autonomously thinks, creates files, writes HTML/JS/CSS, and delivers a playable app. "写一个五子棋网页游戏。" 智能体自主思考、创建文件、编写 HTML/JS/CSS，最终交付可玩的应用。

Gomoku
CLI_EASTER_EGG buddy.ts

CLI Pet 终端宠物

Type `/buddy` in the terminal. Shows off rich text rendering and PRNG capabilities directly in the CLI. 在终端输入 `/buddy`。直接在命令行中展示富文本渲染和伪随机生成能力。

Buddy

Documentation 项目文档

00. Project Outline 项目大纲 01. Core Architecture 核心架构 02. Query Engine 查询引擎 03. Tool System 工具系统 04. Memory 记忆管理 05. MCP & Plugins MCP 与插件 06. UI & Ink UI 与 Ink

Quick Start 快速开始

$ git clone https://github.com/you-want/mini-cc
$ cd mini-cc
$ cp .env.example .env

Configure your API keys in .env and start exploring the core loops. 在 .env 中配置你的 API 密钥，开始探索核心循环。